C# 项目的隐式命名空间

11/21/2021 21:40:11 | China Standard Time

.NET 6 引入了对 C# 项目的隐式命名空间支持，在 .NET 6.0 TFM 以及更高版本中将会利用 C# 10 中引入的 global using 功能隐式包含命名空间，从而减少 .NET C# 项目模板中的 using 指令数量。这篇文章将会介绍 .NET SDK 中隐式包含命名空间的规则。

对于面向 .NET 6.0 TFM 或更高版本且使用 Microsoft.NET.Sdk、Microsoft.NET.Sdk.Web 或 Microsoft.NET.Sdk.Worker SDK 的 C# 项目，默认启用隐式命名空间功能。 此功能将会生成一个传递给编译器的源文件，并包含用于默认命名空间的 global using 指令。

## 更加简洁的控制台模板

.NET 5 中控制台应用程序模板

```csharp
using System;

namespace Company.ConsoleApplication1
{
	class Program
	{
		static void Main(string[] args)
		{
			Console.WriteLine("Hello, World!");
		}
	}
}
```

.NET 6 中凭借 `顶级模式` 以及 `隐式命名空间`，控制台模板将会更加简洁。

```csharp
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");
```

## 默认命名空间

对于面向 .NET 6 或更高版本且使用以下 SDK 之一的 C# 项目，.NET SDK 隐式包含一组默认命名空间：

- Microsoft.NET.Sdk
- Microsoft.NET.Sdk.Web
- Microsoft.NET.Sdk.Worker

通过向项目的 obj 目录中生成的文件添加 global using 指令来包括默认命名空间。 默认命名空间如下：

| SDK 中 IsInRole 中的声明 | 默认命名空间 |
| -------------------------- | ------------ |
| Microsoft.NET.Sdk | System System.Collections.Generic System.IO System.Linq System.Net.Http System.Threading System.Threading.Tasks |
| Microsoft.NET.Sdk.Web | System.Net.Http.Json Microsoft.AspNetCore.Builder Microsoft.AspNetCore.Hosting Microsoft.AspNetCore.Http Microsoft.AspNetCore.Routing Microsoft.Extensions.Configuration Microsoft.Extensions.DependencyInjection Microsoft.Extensions.Hosting Microsoft.Extensions.Logging |
| Microsoft.NET.Sdk.Worker | Microsoft.Extensions.Configuration Microsoft.Extensions.DependencyInjection Microsoft.Extensions.Hosting Microsoft.Extensions.Logging |

这些隐式命名空间可能导致出现类型冲突。 例如，如果要创作一个 MSBuild 任务，进而从抽象 Microsoft.Build.Utilities.Task 类中派生，那么你将看到与 System.Threading.Tasks.Task 类存在冲突。 发生此冲突的原因是隐式包含了 System.Threading.Tasks 命名空间。 该错误如下所示：

```csharp
... error CS0104: 'Task' is an ambiguous reference between 'Microsoft.Build.Utilities.Task' and 'System.Threading.Tasks.Task' 
... error CS0115: 'SomeTask.Execute()': no suitable method found to override
```

你需要`限定类型引用`来解决上述问题。（完整的表述 Task 类属于哪个命名空间）

## 禁用该功能

- 通过在项目文件中将 `DisableImplicitNamespaceImports` 设置为 `true`，完全禁用该功能。

```xml
<PropertyGroup>
	<DisableImplicitNamespaceImports>true</DisableImplicitNamespaceImports>
</PropertyGroup>
```

- 通过在项目文件中将 `DisableImplicitNamespaceImports_DotNet`、`DisableImplicitNamespaceImports_Web` 或 `DisableImplicitNamespaceImports_Worker` 属性设置为 `true`，禁用 SDK 添加的一组隐式命名空间。

```xml
<PropertyGroup>
	<DisableImplicitNamespaceImports_DotNet>true</DisableImplicitNamespaceImports_DotNet>
</PropertyGroup>
```

- 通过修改项目文件中的 项组来添加或删除各个命名空间。 例如：

```xml
<ItemGroup>
	<Import Remove="System.Net.Http" />
	<Import Include="System.IO.Pipes" />
</ItemGroup>
```

TOP