命名空间声明首选项（IDE0160 和 IDE0161）
本文介绍了两个相关的规则：IDE0160 和 IDE0161。
| 属性 | 值 |
|---|---|
| 规则 ID | IDE0160 |
| 标题 | 使用以程序块为作用域的命名空间 |
| 类别 | Style |
| Subcategory | 语言规则（代码块首选项） |
| 适用的语言 | C# |
| 选项 | csharp_style_namespace_declarations |
| 属性 | 值 |
|---|---|
| 规则 ID | IDE0161 |
| 标题 | 使用以文件为作用域的命名空间 |
| 类别 | Style |
| Subcategory | 语言规则（代码块首选项） |
| 适用的语言 | C# |
| 选项 | csharp_style_namespace_declarations |
概述
这些规则适用于命名空间声明。 要使 IDE0161 在使用以程序块为作用域的命名空间时报告冲突，必须将关联的选项设置为 file_scoped。
选项
此选项值指定命名空间声明应当以程序块为作用域还是以文件为作用域。 默认情况下，命名空间声明以块为作用域。 Visual Studio 使用此选项来确定将新的代码文件添加到项目时如何声明命名空间。 即使同时禁用了 IDE0160 和 IDE0161，Visual Studio 也会遵从此选项值。
若要了解如何配置选项，请参阅选项格式。
csharp_style_namespace_declarations
| 属性 | 值 | 说明 |
|---|---|---|
| 选项名称 | csharp_style_namespace_declarations | |
| 适用的语言 | C# | |
| 引入的版本 | Visual Studio 2019 | |
| 选项值 | block_scoped |
命名空间声明应当以程序块为作用域。 |
file_scoped |
命名空间声明应当以文件为作用域。 | |
| 默认选项值 | block_scoped |
// csharp_style_namespace_declarations = block_scoped
using System;
namespace Convention
{
class C
{
}
}
// csharp_style_namespace_declarations = file_scoped
using System;
namespace Convention;
class C
{
}
抑制警告
如果只想抑制单个冲突，请将预处理器指令添加到源文件以禁用该规则，然后重新启用该规则。
#pragma warning disable IDE0160 // Or IDE0161
// The code that's violating the rule is on this line.
#pragma warning restore IDE0160 // Or IDE0161
若要对文件、文件夹或项目禁用该规则，请在配置文件中将其严重性设置为 none。
[*.{cs,vb}]
dotnet_diagnostic.IDE0160.severity = none
dotnet_diagnostic.IDE0161.severity = none
若要禁用所有代码样式规则，请在配置文件中将类别 Style 的严重性设置为 none。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
有关详细信息，请参阅如何禁止显示代码分析警告。
