Udostępnij za pośrednictwem

Preferencje deklaracji przestrzeni nazw (IDE0160 i IDE0161)

  • Artykuł

W tym artykule opisano dwie powiązane reguły, IDE0160 i IDE0161.

Własność Wartość
identyfikator reguły IDE0160
Tytuł Używaj przestrzeni nazw o zakresie bloku
Kategoria Styl
podkategoria Reguły języka (preferencje bloku kodu)
Stosowane języki C#
opcje csharp_style_namespace_declarations
Własność Wartość
identyfikator reguły IDE0161
Tytuł Korzystanie z przestrzeni nazw o zakresie plików
Kategoria Styl
Podkategoria Reguły języka (preferencje bloku kodu)
odpowiednie języki C#
opcje csharp_style_namespace_declarations

Przegląd

Te reguły dotyczą deklaracji przestrzeni nazw . Aby IDE0161 zgłaszał naruszenia, gdy używane są przestrzenie nazw zakresu bloku, należy ustawić skojarzoną opcję na file_scoped.

Opcje

Wartość opcji określa, czy deklaracje przestrzeni nazw powinny być objęte zakresem bloku, czy zakresem pliku. Domyślnie deklaracje przestrzeni nazw mają zakres blokowy. Ta opcja jest używana przez program Visual Studio do określania, w jaki sposób przestrzenie nazw są deklarowane podczas dodawania nowych plików kodu do projektów. Program Visual Studio honoruje wartość opcji, nawet jeśli zarówno IDE0160, jak i IDE0161 są wyłączone.

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

csharp_style_deklaracje_przestrzeni_nazw

Własność Wartość Opis
nazwa opcji Deklaracje przestrzeni nazw w stylu CSharp
stosowane języki C#
wprowadzona wersja Visual Studio 2019
wartości opcji block_scoped Deklaracje przestrzeni nazw powinny być ograniczone do zakresu blokowego.
file_scoped Deklaracje przestrzeni nazw powinny być ograniczone do zakresu pliku.
domyślna wartość opcji 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ść reguł w kategorii Style na none w pliku konfiguracyjnym .

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

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

Zobacz też