命名空间声明首选项(IDE0160和IDE0161)

本文介绍两个相关规则,IDE0160IDE0161

财产 价值
规则 ID IDE0160
标题 使用以程序块为作用域的命名空间
类别 样式
子类别 语言规则(代码块首选项)
适用的语言 C#
选项 csharp_style_namespace_declarations
财产 价值
规则 ID IDE0161
标题 使用以文件为作用域的命名空间
类别 样式
子类别 语言规则(代码块首选项)
适用的语言 C#
选项 csharp_style_namespace_declarations

概述

这些规则适用于 命名空间声明。 要使 IDE0161 在使用以程序块为作用域的命名空间时报告冲突,必须将关联的选项设置为 file_scoped

选项

选项值指定命名空间声明应是块作用域还是文件作用域。 默认情况下,命名空间声明以块为作用域。 Visual Studio 使用此选项来确定将新代码文件添加到项目时如何声明命名空间。 即使禁用 IDE0160IDE0161,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

有关详细信息,请参阅 如何取消代码分析警告

另请参阅