命名空间声明首选项(IDE0160和IDE0161)
本文介绍两个相关规则,IDE0160
和 IDE0161
。
财产 | 价值 |
---|---|
规则 ID | IDE0160 |
标题 | 使用以程序块为作用域的命名空间 |
类别 | 样式 |
子类别 | 语言规则(代码块首选项) |
适用的语言 | C# |
选项 | csharp_style_namespace_declarations |
财产 | 价值 |
---|---|
规则 ID | IDE0161 |
标题 | 使用以文件为作用域的命名空间 |
类别 | 样式 |
子类别 | 语言规则(代码块首选项) |
适用的语言 | 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
有关详细信息,请参阅 如何取消代码分析警告。