CODEWITHSUNDEEP
c#.net-6.0visual-studio-2022using-directivesc#-10.0
Stefan
Stefan

Reputation: 1287

How do I control what usings are made global in a C#10 / .NET6.0 project?

C#10 in .NET 6.0 supports a new feature called global using directive.

It seems to do 2 things:

I know I can disable the implicit adding of namespaces to the global usings by adding the following to my project file:

<PropertyGroup>
    <ImplicitUsings>disable</ImplicitUsings>
</PropertyGroup>

My question:

  1. Is this global using directive feature just for convenience so that some often used namespaces are included globally, so these usings don't clutter the top of your *.cs files?
  2. Is it possible to add my own global usings?
  3. Is it possible to remove some implicitly included global usings (e.g. in case of name clashes)?
  4. Does this this global using directive feature has other uses I did not think off?

The global-usings file states // <auto-generated/> at the top so I cannot just add/remove/edit global-usings in this file.

Upvotes: 12

Views: 11174

Answers (2)

Guru Stron
Guru Stron

Reputation: 142303

Is this global using directive feature just for convenience so that some often used namespaces are included globally, so these usings don't clutter the top of your *.cs files?

Yes, they are just for convenience when working with namespaces (reduce clutter, create global aliases, easier namespace management overall)

Is it possible to add my own global usings?

Yes, you can add global usings to the project either by adding global using Some.Namespace; to the top of one of the files (you can create a separate one specially for that) or by adding the following to the .cproj:

<ItemGroup>
    <Using Include="Some.Namespace"/>
</ItemGroup>

Is it possible to remove some implicitly included global usings (e.g. in case of name clashes)?

Yes, you can remove automatically imported namespaces (from the project default imports with ImplicitUsings) with

<ItemGroup>
    <Using Remove="Some.Namespace"/>
</ItemGroup>

Does this this global using directive feature has other uses I did not think off?

No AFAIK, except for mentioned earlier.

Useful links:

Upvotes: 17

Mayur Ekbote
Mayur Ekbote

Reputation: 2080

  1. Mostly yes. You can move your classes from one globally used namespace to another without changing the source code. Which massively saves time during refactoring.
  2. Yes. Instead of using namespace_name declare global using namespace_name that's it! This declaration can be anywhere in the project. Ideally, create an import.cs file and declare all your globally used namespaces there.
  3. Yes. Find where it is declared as global using nameclashing_namespace and remove the global word.
  4. I can't think of any apart from (1) above.

Upvotes: 1

Related Questions