Freigeben über

Namespacedeklarationseinstellungen (IDE0160 und IDE0161)

  • Artikel

In diesem Artikel werden zwei verwandte Regeln, IDE0160 und IDE0161beschrieben.

Eigentum Wert
Regel-ID IDE0160
Titel Blockbezogenen Namespace verwenden
Kategorie Stil
Unterkategorie Sprachregeln (Codeblock-Präferenzen)
Anwendbare Sprachen C#
Optionen csharp_style_namespace_declarations
Eigentum Wert
Regel-ID IDE0161
Titel Dateibezogenen Namespace verwenden
Kategorie Stil
Unterkategorie Sprachregeln (Codeblock-Präferenzen)
Anwendbare Sprachen C#
Optionen csharp_style_namespace_declarations

Überblick

Diese Regeln gelten für Namespace-Deklarationen. Damit IDE0161 Verstöße meldet, wenn Blockbereichsnamespaces verwendet werden, müssen Sie die zugehörige Option auf file_scopedfestlegen.

Optionen

Der Optionswert gibt an, ob Namespacedeklarationen blockbezogen oder dateibezogen sein sollen. Standardmäßig sind Namespacedeklarationen blockbezogen. Diese Option wird von Visual Studio verwendet, um zu bestimmen, wie Namespaces deklariert werden, wenn neue Codedateien zu Projekten hinzugefügt werden. Visual Studio berücksichtigt den Optionswert, auch wenn sowohl IDE0160 als auch IDE0161 deaktiviert sind.

Informationen zum Konfigurieren von Optionen finden Sie unter Option format.

csharp_style_namespace_declarations

Eigentum Wert Beschreibung
Name der Option csharp_style_namespace_declarations
Anwendbare Sprachen C#
Eingeführt in Version Visual Studio 2019
Optionswerte block_scoped Namespace-Deklarationen sollten blockweise beschränkt sein.
file_scoped Namespacedeklarationen sollten dateibereichsbezogener Art sein.
Standardoptionenwert 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
{
}

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut zu aktivieren.

#pragma warning disable IDE0160 // Or IDE0161
// The code that's violating the rule is on this line.
#pragma warning restore IDE0160 // Or IDE0161

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdateiauf none fest.

[*.{cs,vb}]
dotnet_diagnostic.IDE0160.severity = none
dotnet_diagnostic.IDE0161.severity = none

Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie Style in der Konfigurationsdateiauf none fest.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.

Siehe auch