Share via

CA1000: Nedeklarujte statické členy v obecných typech

  • Článek
Vlastnost Hodnota
ID pravidla CA1000
Název Nedeklarujte statické členy v obecných typech
Kategorie Návrh
Oprava způsobující chybu nebo chybu způsobující chybu Narušující
Povoleno ve výchozím nastavení v .NET 8 No

Příčina

Obecný typ obsahuje člena static (Shared v jazyce Visual Basic).

Ve výchozím nastavení toto pravidlo sleduje jenom externě viditelné typy, ale dá se konfigurovat.

Popis pravidla

static Pokud je volána člena obecného typu, musí být pro typ zadán argument typu. Je-li zavolán obecný člen instance, který nepodporuje odvozování, musí být pro tento člen zadán argument typu. Syntaxe pro zadání argumentu typu v těchto dvou případech je odlišná a snadno zmatená, protože následující volání ukazují:

' Shared method in a generic type.
GenericType(Of Integer).SharedMethod()

' Generic instance method that does not support inference.
someObject.GenericMethod(Of Integer)()

// Static method in a generic type.
GenericType<int>.StaticMethod();

// Generic instance method that does not support inference.
someObject.GenericMethod<int>();

Obecně platí, že obě předchozí deklarace by se měly vyhnout, aby argument typu nemusel být zadán při zavolání členu. Výsledkem je syntaxe pro volání členů v obecných objektech, které se neliší od syntaxe pro jiné než obecné typy.

Jak opravit porušení

Chcete-li opravit porušení tohoto pravidla, odeberte statický člen nebo ho změňte na člena instance.

Kdy potlačit upozornění

Nepotlačujte upozornění na toto pravidlo. Poskytnutí obecných typů v syntaxi, která je snadno pochopitelná a využitá, zkracuje dobu potřebnou k učení a zvyšuje míru přijetí nových knihoven.

Potlačení upozornění

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

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

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

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

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

Konfigurace kódu pro analýzu

Pomocí následující možnosti nakonfigurujte, ve kterých částech základu kódu se má toto pravidlo spouštět.

Tuto možnost můžete nakonfigurovat pouze pro toto pravidlo, pro všechna pravidla, která se vztahují, nebo pro všechna pravidla v této kategorii (návrh), na která platí. Další informace naleznete v tématu Možnosti konfigurace pravidla kvality kódu.

Zahrnutí konkrétních povrchů rozhraní API

Na základě přístupnosti můžete nakonfigurovat, na kterých částech základu kódu se má toto pravidlo spouštět. Pokud chcete například určit, že pravidlo by se mělo spouštět jenom na neveřejné ploše rozhraní API, přidejte do souboru .editorconfig v projektu následující pár klíč-hodnota:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Viz také