Preferencje deklaracji przestrzeni nazw (IDE0160 i IDE0161)

  • Artykuł

W tym artykule opisano dwie powiązane reguły i IDE0160IDE0161.

Właściwość Wartość
Identyfikator zasady IDE0160
Tytuł Używanie przestrzeni nazw o zakresie bloku
Kategoria Styl
Subcategory (Podkategoria) Reguły języka (preferencje bloków kodu)
Odpowiednie języki C#
Opcje csharp_style_namespace_declarations
Właściwość Wartość
Identyfikator zasady IDE0161
Tytuł Korzystanie z przestrzeni nazw o zakresie plików
Kategoria Styl
Subcategory (Podkategoria) Reguły języka (preferencje bloków kodu)
Odpowiednie języki C#
Opcje csharp_style_namespace_declarations

Omówienie

Te reguły dotyczą deklaracji przestrzeni nazw. Aby IDE0161 zgłaszać naruszenia, gdy są używane przestrzenie nazw o zakresie bloku, należy ustawić skojarzona opcja na file_scoped.

Opcje

Wartość opcji określa, czy deklaracje przestrzeni nazw powinny być objęte zakresem bloku lub zakresem pliku. Domyślnie deklaracje przestrzeni nazw są ograniczone do zakresu bloków. Ta opcja jest używana przez program Visual Studio do określania, w jaki sposób przestrzenie nazw są deklarowane po dodaniu nowych plików kodu do projektów. Program Visual Studio honoruje wartość opcji, nawet jeśli obie IDE0160 opcje i IDE0161 są wyłączone.

Aby uzyskać informacje na temat konfigurowania opcji, zobacz Format opcji.

csharp_style_namespace_declarations

Właściwość Wartość Opis
Nazwa opcji csharp_style_namespace_declarations
Odpowiednie języki C#
Wprowadzona wersja Visual Studio 2019
Wartości opcji block_scoped Deklaracje przestrzeni nazw powinny mieć zakres bloków.
file_scoped Deklaracje przestrzeni nazw powinny mieć zakres plików.
Wartość opcji domyślnej 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
{
}

Pomijanie ostrzeżenia

Jeśli chcesz pominąć tylko jedno naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

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

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.

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

Aby wyłączyć wszystkie reguły stylu kodu, ustaw ważność dla kategorii Style na none w pliku konfiguracji.

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

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia analizy kodu.

Zobacz też