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

  • Artykuł
Właściwości Wartość
Identyfikator reguły CA1000
Stanowisko Nie deklaruj statycznych składowych na typach ogólnych
Kategoria Projekt
Poprawka powodująca niezgodność lub niezgodność Kluczowa
Domyślnie włączone na platformie .NET 8 Nie.

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. Po wywołaniu wystąpienia ogólnego elementu członkowskiego, które nie obsługuje wnioskowania, 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 zdezorientowana, jak pokazują następujące 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, gdy element członkowski jest wywoływany. Powoduje to składnię wywoływania elementów członkowskich w rodzajach ogólnych, które nie różnią się od składni dla niegenerycznych.

Jak naprawić naruszenia

Aby naprawić naruszenie tej reguły, usuń statyczny element członkowski lub zmień go na członka wystąpienia.

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 bazy kodu mają być uruchamiane w tej regule.

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órych częściach bazy kodu ma być uruchamiana ta reguła, na podstawie ich ułatwień dostępu. 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

Zobacz też