Sdílet prostřednictvím

Předvolby deklarace oboru názvů (IDE0160 a IDE0161)

  • Článek

Tento článek popisuje dvě související pravidla, IDE0160 a IDE0161.

Vlastnost Hodnota
ID pravidla IDE0160
název Použijte obor názvů s blokovým rozsahem
Kategorie Styl
podkategorie Jazyková pravidla (předvolby bloku kódu)
příslušné jazyky C#
Možnosti csharp_style_namespace_declarations
Vlastnost Hodnota
ID pravidla IDE0161
název Použijte obor názvů omezený na soubor
Kategorie Styl
podkategorie Jazyková pravidla (předvolby bloku kódu)
příslušné jazyky C#
Možnosti csharp_style_namespace_declarations

Přehled

Tato pravidla platí pro deklarace jmenného prostoru . Chcete-li, aby IDE0161 ohlásil porušení při použití jmenných prostorů omezených blokem, je třeba nastavit přidruženou možnost file_scoped.

Možnosti

Hodnota možnosti určuje, jestli mají být deklarace oboru názvů blokované nebo s oborem souboru. Ve výchozím nastavení jsou deklarace oboru názvů blokově omezené. Tato možnost se používá v sadě Visual Studio k určení způsobu deklarace oborů názvů při přidání nových souborů kódu do projektů. Visual Studio respektuje hodnotu nastavení, i když jsou zakázány i IDE0160 a IDE0161.

Informace o nastavení možností naleznete v tématu Formát možnosti.

csharp_style_namespace_declarations

Vlastnost Hodnota Popis
název možnosti csharp_styl_prohlášení_prostor_jmen
příslušné jazyky C#
Zavedená verze Visual Studio 2019
hodnoty možností block_scoped Deklarace oboru názvů by měly mít blokový rozsah.
file_scoped Deklarace oboru názvů by měly být vymezeny na úrovni souboru.
výchozí hodnota možnosti 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
{
}

Potlačení upozornění

Pokud chcete potlačit pouze jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Chcete-li pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost na none v konfiguračním souboru .

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

Chcete-li zakázat všechna pravidla stylu kódu, nastavte závažnost pro kategorii Style na none v konfiguračním souboru .

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Viz také