Share via

CA1813: Niet-verzegelde kenmerken voorkomen

  • Artikel
Eigenschappen Weergegeven als
Regel-id CA1813
Titel Niet-verzegelde kenmerken voorkomen
Categorie Prestaties
Oplossing is brekend of niet-brekend Breken
Standaard ingeschakeld in .NET 9 Nee

Oorzaak

Een openbaar type neemt over System.Attributevan, is niet abstract en is niet verzegeld (NotInheritable in Visual Basic).

Beschrijving van regel

.NET biedt methoden voor het ophalen van aangepaste kenmerken. Deze methoden doorzoeken standaard de overnamehiërarchie van kenmerken. Zoekt bijvoorbeeld System.Attribute.GetCustomAttribute naar het opgegeven kenmerktype of een kenmerktype dat het opgegeven kenmerktype uitbreidt. Het afdichten van het kenmerk elimineert de zoekopdracht via de overnamehiërarchie en kan de prestaties verbeteren.

Schendingen oplossen

Als u een schending van deze regel wilt oplossen, verzegelt u het kenmerktype of maakt u deze abstract.

Wanneer waarschuwingen onderdrukken

Het is veilig om een waarschuwing van deze regel te onderdrukken. Alleen onderdrukken als u een kenmerkhiërarchie definieert en het kenmerk niet kan verzegelen of abstract maken.

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

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

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.

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

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Opmerking

In het volgende voorbeeld ziet u een aangepast kenmerk dat voldoet aan deze regel.

// Satisfies rule: AvoidUnsealedAttributes.
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
public sealed class DeveloperAttribute : Attribute
{
    private string nameValue;
    public DeveloperAttribute(string name)
    {
        nameValue = name;
    }

    public string Name
    {
        get
        {
            return nameValue;
        }
    }
}

Imports System

Namespace ca1813

    ' Satisfies rule: AvoidUnsealedAttributes.
    <AttributeUsage(AttributeTargets.Class Or AttributeTargets.Struct)>
    Public NotInheritable Class DeveloperAttribute
        Inherits Attribute

        Public Sub New(name As String)
            Me.Name = name
        End Sub


        Public ReadOnly Property Name() As String
    End Class

End Namespace

Zie ook