C#10 in .NET 6.0 supports a new feature called global using directive.
It seems to do 2 things:
- When you have a namespace in the global using, you don't have to include the
using ...
for that namespace at the top of your *.cs files. - Some namespaces are implicitly added to the global usings, which ones depend on the project type it seems.
I know I can disable the implicit adding of namespaces to the global usings by adding the following to my project file:
<PropertyGroup>
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
My question:
- 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?
- Is it possible to add my own global usings?
- Is it possible to remove some implicitly included global usings (e.g. in case of name clashes)?
- 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.
CodePudding user response:
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 Exclude="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:
- Where are the using statements/directives in .NET 6 answer
- Implicit using directives per SDK used
Using
MSBuild prop- Global Using Directive feature specification
global
modifier language reference
CodePudding user response:
- 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.
- Yes. Instead of
using namespace_name
declareglobal using namespace_name
that's it! This declaration can be anywhere in the project. Ideally, create animport.cs
file and declare all your globally used namespaces there. - Yes. Find where it is declared as
global using nameclashing_namespace
and remove the global word. - I can't think of any apart from (1) above.