Udostępnij za pośrednictwem

CA1200: Unikaj używania tagów cref z prefiksem

Właściwości Wartość
Identyfikator reguły CA1200
Tytuł Unikaj używania tagów cref z prefiksem
Kategoria Dokumentacja
Poprawka łamiąca lub nienaruszająca Niezgodność
Domyślnie włączone na platformie .NET 10 Nie.
Zastosowane języki C# i Visual Basic

Przyczyna

Tag cref w komentarzu dokumentacji XML używa prefiksu.

Opis reguły

Atrybut cref w tagu dokumentacji XML oznacza "odwołanie do kodu". Określa, że tekst wewnętrzny tagu jest elementem kodu, takim jak typ, metoda lub właściwość. Unikaj używania cref tagów z prefiksami, ponieważ uniemożliwia kompilatorowi weryfikowanie odwołań. Zapobiega to również znajdowaniu i aktualizowaniu tych odwołań do symboli przez zintegrowane środowisko programistyczne (IDE) Visual Studio podczas refaktoryzacji. Zaleca się używanie pełnej składni bez prefiksów do odwołwania się do nazw symboli w tagach cref.

Jak naprawić naruszenia

Aby naprawić naruszenie tej reguły, usuń prefiks z tagu cref . Na przykład następujące dwa fragmenty kodu pokazują naruszenie reguły i sposób jego naprawy:

// Violates CA1200
/// <summary>
/// Type <see cref="T:C" /> contains method <see cref="F:C.F" />
/// </summary>
class C
{
    public void F() { }
}

// Does not violate CA1200
/// <summary>
/// Type <see cref="C" /> contains method <see cref="F" />
/// </summary>
class C
{
    public void F() { }
}

Kiedy pomijać ostrzeżenia

Można bezpiecznie zignorować to ostrzeżenie, jeśli odwołanie do kodu musi używać prefiksu, ponieważ kompilator nie może znaleźć odwoływanego typu. Jeśli na przykład odwołanie do kodu odwołuje się do specjalnego atrybutu w pełnej strukturze, ale plik kompiluje się na przenośnej strukturze, możesz pominąć to ostrzeżenie.

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

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

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

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

Zobacz też

  • Last updated on