Namespacedeklarationseinstellungen (IDE0160 und IDE0161)

  • Artikel

In diesem Artikel werden zwei verwandte Regeln beschrieben, IDE0160 und IDE0161.

Eigenschaft Wert
Regel-ID IDE0160
Titel Blockbezogenen Namespace verwenden
Kategorie Stil
Unterkategorie Sprachregeln (Codeblockeinstellungen)
Gültige Sprachen C#
Optionen csharp_style_namespace_declarations
Eigenschaft Wert
Regel-ID IDE0161
Titel Dateibezogenen Namespace verwenden
Kategorie Stil
Unterkategorie Sprachregeln (Codeblockeinstellungen)
Gültige Sprachen C#
Optionen csharp_style_namespace_declarations

Übersicht

Diese Regeln gelten für Namespacedeklarationen. Damit IDE0161 bei der Verwendung von blockbezogenen Namespace Verstöße meldet, müssen Sie die zugeordnete Option auf file_scoped festlegen.

Optionen

Der Optionswert gibt an, ob Namespacedeklarationen block- 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 selbst dann, wenn sowohl IDE0160 als auch IDE0161 deaktiviert sind.

Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

csharp_style_namespace_declarations

Eigenschaft Wert Beschreibung
Name der Option csharp_style_namespace_declarations
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2019
Optionswerte block_scoped Namespacedeklarationen sollten blockbezogen sein.
file_scoped Namespacedeklarationen sollten dateibezogen sein.
Standardoptionswert 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

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder 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 Konfigurationsdatei auf none fest.

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

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie in der KonfigurationsdateiStyle auf none.

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

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Siehe auch