Udostępnij za pośrednictwem

CA1000: Nie deklaruj statycznych elementów członkowskich na typach generycznych

Właściwości Wartość
Identyfikator reguły CA1000
Tytuł Nie deklaruj statycznych składowych na typach ogólnych
Kategoria Projektowanie
Poprawka łamiąca lub nienaruszająca Przełomowe
Domyślnie włączone na platformie .NET 10 Nie.
Zastosowane języki C# i Visual Basic

Przyczyna

Typ ogólny zawiera element członkowski static (Shared w Visual Basic).

Domyślnie ta reguła analizuje tylko typy widoczne zewnętrznie, ale można to skonfigurować.

Opis reguły

Gdy element static członkowski typu ogólnego jest wywoływany, argument typu musi być określony dla typu. Gdy wywoływany jest ogólny element członkowski, który nie obsługuje wnioskowania typu, dla elementu członkowskiego musi zostać określony argument typu. Składnia określania argumentu typu w tych dwóch przypadkach jest inna i łatwo można je pomylić, co pokazują poniższe wywołania.

' 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>();

Ogólnie rzecz biorąc, należy unikać obu poprzednich deklaracji, aby argument typu nie musiał być określony przy wywoływaniu elementu. Powoduje to składnię wywoływania członków w generykach, która nie różni się od składni dla niegenerycznych.

Jak naprawić naruszenia

Aby naprawić naruszenie tej reguły, usuń członka statycznego lub zmień go na członka zwykłego.

Kiedy pomijać ostrzeżenia

Nie pomijaj ostrzeżeń dla tej reguły. Udostępnianie typów ogólnych w składni, która jest łatwa do zrozumienia i używania skraca czas wymagany do nauki i zwiększa szybkość wdrażania nowych bibliotek.

Pomijanie ostrzeżenia

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

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

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

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

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

Konfigurowanie kodu do analizowania

Użyj następującej opcji, aby skonfigurować, które części kodu mają być objęte tą regułą.

Tę opcję można skonfigurować tylko dla tej reguły, dla wszystkich reguł, do których ma ona zastosowanie, lub dla wszystkich reguł w tej kategorii (Projekt), do których ma ona zastosowanie. Aby uzyskać więcej informacji, zobacz Opcje konfiguracji reguły jakości kodu.

Uwzględnij określone powierzchnie interfejsu API

Możesz skonfigurować, na które części bazy kodu ma być stosowana ta reguła, na podstawie ich poziomu dostępu, ustawiając opcję api_surface. Aby na przykład określić, że reguła powinna być uruchamiana tylko na powierzchni niepublicznego interfejsu API, dodaj następującą parę klucz-wartość do pliku editorconfig w projekcie:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Notatka

Zastąp część XXXXCAXXXX identyfikatorem odpowiedniej reguły.

Zobacz też

  • Last updated on