Namespace declaration preferences (IDE0160 and IDE0161)
This article describes two related rules, IDE0160
and IDE0161
.
Property | Value |
---|---|
Rule ID | IDE0160 |
Title | Use block-scoped namespace |
Category | Style |
Subcategory | Language rules (code-block preferences) |
Applicable languages | C# |
Options | csharp_style_namespace_declarations |
Property | Value |
---|---|
Rule ID | IDE0161 |
Title | Use file-scoped namespace |
Category | Style |
Subcategory | Language rules (code-block preferences) |
Applicable languages | C# |
Options | csharp_style_namespace_declarations |
These rules apply to namespace declarations. For IDE0161
to report violations when block-scoped namespaces are used, you must set the associated option to file_scoped
.
The option value specifies whether namespace declarations should be block scoped or file scoped. By default, namespace declarations are block-scoped. This option is used by Visual Studio to determine how namespaces are declared when new code files are added to projects. Visual Studio honors the option value even if both IDE0160
and IDE0161
are disabled.
For information about configuring options, see Option format.
Property | Value | Description |
---|---|---|
Option name | csharp_style_namespace_declarations | |
Applicable languages | C# | |
Introduced version | Visual Studio 2019 | |
Option values | block_scoped |
Namespace declarations should be block scoped. |
file_scoped |
Namespace declarations should be file scoped. | |
Default option value | 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
{
}
If you want to suppress only a single violation, add preprocessor directives to your source file to disable and then re-enable the rule.
#pragma warning disable IDE0160 // Or IDE0161
// The code that's violating the rule is on this line.
#pragma warning restore IDE0160 // Or IDE0161
To disable the rule for a file, folder, or project, set its severity to none
in the configuration file.
[*.{cs,vb}]
dotnet_diagnostic.IDE0160.severity = none
dotnet_diagnostic.IDE0161.severity = none
To disable all of the code-style rules, set the severity for the category Style
to none
in the configuration file.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
For more information, see How to suppress code analysis warnings.
.NET feedback
.NET is an open source project. Select a link to provide feedback: