Obor názvů neodpovídá struktuře složek (IDE0130)

Článek
02/09/2025

Vlastnost	Hodnota
ID pravidla	IDE0130
název	Jmenný prostor neodpovídá struktuře složek
kategorie	Styl
podkategorie	Jazyková pravidla (předvolby na úrovni výrazu)
příslušné jazyky	C# a Visual Basic
Možnosti	`dotnet_style_namespace_match_folder`

Přehled

Toto pravidlo stylu používá strukturu složek projektu k vynucení požadavků na pojmenování oboru názvů.

Možnosti

Možnosti určují chování, které má pravidlo vynutit. Pro informace o konfiguraci možností, viz formát možností.

dotnet_style_namespace_match_folder

Vlastnost	Hodnota	Popis
název možnosti	dotnet_style_namespace_match_folder
hodnoty možností	`true`	Preferovat pojmenování názvových oborů, aby odpovídalo struktuře složek.
	`false`	Zakáže pravidlo.
výchozí hodnota možnosti	`true`

Poznámka

Možnost dotnet_style_namespace_match_folder závisí na znalosti aktuálního projektu a vlastností kořenového jmenného prostoru. Tyto informace poskytuje Sada Visual Studio, ale nejsou k dispozici pro sestavení příkazového řádku, jako je například dotnet build. Aby sestavení příkazového řádku fungovala, musíte do souboru projektu přidat následující vlastnosti:

<ItemGroup>
  <CompilerVisibleProperty Include="RootNamespace" />
  <CompilerVisibleProperty Include="ProjectDir" />
</ItemGroup>

Příklad

Předpokládejme, že následující fragmenty kódu pocházejí ze souboru s názvem Data/Example.cs nebo Data/Example.vb, kde Data představuje strukturu složek ze souboru projektu. Název struktury složek se přidá do kořenového oboru názvů, který je v tomto příkladu Root.

// Code with violations
namespace Root.BadExample
{
    class Example
    {
        public void M()
        {
        }
    }
}

// Fixed code
namespace Root.Data
{
    class Example
    {
        public void M()
        {
        }
    }
}

' Code with violations
Namespace Root.BadExample
    Class Example
        Public Sub M()
        End Sub
    End Class
End Namespace

' Fixed code
Namespace Root.Data
    Class Example
        Public Sub M()
        End Sub
    End Class
End Namespace

Potlačte 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 IDE0130
// The code that's violating the rule is on this line.
#pragma warning restore IDE0130

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.IDE0130.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é

Pravidla jazyka
Referenční pravidla stylu kódu

Sdílet prostřednictvím