CA1012: Typy abstrakcyjne nie powinny mieć publicznych konstruktorów
| Właściwości | Wartość |
|---|---|
| Identyfikator reguły | CA1012 |
| Stanowisko | Typy abstrakcyjne nie powinny mieć publicznych konstruktorów |
| Kategoria | Projekt |
| Poprawka powodująca niezgodność lub niezgodność | Niezgodność |
| Domyślnie włączone na platformie .NET 8 | Nie. |
Przyczyna
Typ jest abstrakcyjny i ma publiczny konstruktor.
Domyślnie ta reguła analizuje tylko typy widoczne zewnętrznie, ale można to skonfigurować.
Opis reguły
Konstruktory dla typów abstrakcyjnych mogą być wywoływane tylko przez typy pochodne. Ponieważ konstruktory publiczne tworzą wystąpienia typu i nie można tworzyć wystąpień typu abstrakcyjnego, typ abstrakcyjny, który ma konstruktor publiczny, jest niepoprawnie zaprojektowany.
Jak naprawić naruszenia
Aby naprawić naruszenie tej reguły, należy włączyć ochronę konstruktora lub nie zadeklarować typu jako abstrakcyjnego.
Kiedy pomijać ostrzeżenia
Nie pomijaj ostrzeżeń dla tej reguły. Typ abstrakcyjny ma konstruktor publiczny.
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 CA1012
// The code that's violating the rule is on this line.
#pragma warning restore CA1012
Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.
[*.{cs,vb}]
dotnet_diagnostic.CA1012.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), których dotyczy. 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
Przykład
Poniższy fragment kodu zawiera typ abstrakcyjny, który narusza tę regułę.
' Violates this rule
Public MustInherit Class Book
Public Sub New()
End Sub
End Class
// Violates this rule
public abstract class Book
{
public Book()
{
}
}
Poniższy fragment kodu naprawia poprzednie naruszenie, zmieniając dostępność konstruktora z public na protected.
// Does not violate this rule
public abstract class Book
{
protected Book()
{
}
}
' Violates this rule
Public MustInherit Class Book
Protected Sub New()
End Sub
End Class
