Share via

CA1721: Eigenschapsnamen mogen niet overeenkomen met get-methoden

  • Artikel
Eigenschappen Weergegeven als
Regel-id CA1721
Titel Eigenschapsnamen mogen niet overeenkomen met get-methoden
Categorie Naamgeving
Oplossing is brekend of niet-brekend Breken
Standaard ingeschakeld in .NET 9 Nee

Oorzaak

De naam van een lid begint met 'Ophalen' en komt anders overeen met de naam van een eigenschap. Een type dat bijvoorbeeld een methode bevat met de naam 'GetColor' en een eigenschap met de naam 'Color' veroorzaakt een schending van de regel. Deze regel wordt niet geactiveerd als de eigenschap of de methode is gemarkeerd met de ObsoleteAttribute.

Deze regel kijkt standaard alleen naar extern zichtbare leden en eigenschappen, maar dit is configureerbaar.

Beschrijving van regel

'Get'-methoden en -eigenschappen moeten namen hebben die hun functie duidelijk onderscheiden.

Naamconventies bieden een gemeenschappelijk uiterlijk voor bibliotheken die gericht zijn op de algemene taalruntime. Deze consistentie vermindert de tijd die nodig is om een nieuwe softwarebibliotheek te leren en verhoogt het vertrouwen van de klant dat de bibliotheek is ontwikkeld door iemand die ervaring heeft met het ontwikkelen van beheerde code.

Schendingen oplossen

Wijzig de naam zodat deze niet overeenkomt met de naam van een methode die wordt voorafgegaan door 'Get'.

Wanneer waarschuwingen onderdrukken

Een waarschuwing van deze regel niet onderdrukken. Een uitzondering op die regel is als de methode Get wordt veroorzaakt door het implementeren van de IExtenderProvider interface.

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

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.CA1721.severity = none

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Code configureren om te analyseren

Gebruik de volgende optie om te configureren op welke onderdelen van uw codebase deze regel moet worden uitgevoerd.

U kunt deze optie configureren voor alleen deze regel, voor alle regels waarop deze van toepassing is, of voor alle regels in deze categorie (naamgeving) waarop deze van toepassing is. Zie de configuratieopties voor de codekwaliteitsregel voor meer informatie.

Specifieke API-oppervlakken opnemen

U kunt instellen op welke onderdelen van uw codebase deze regel moet worden uitgevoerd, op basis van hun toegankelijkheid. Als u bijvoorbeeld wilt opgeven dat de regel alleen moet worden uitgevoerd op het niet-openbare API-oppervlak, voegt u het volgende sleutel-waardepaar toe aan een .editorconfig-bestand in uw project:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Opmerking

Het volgende voorbeeld bevat een methode en eigenschap die deze regel schenden.

public class Test
{
    public DateTime Date
    {
        get { return DateTime.Today; }
    }

    // Violates rule: PropertyNamesShouldNotMatchGetMethods.
    public string GetDate()
    {
        return this.Date.ToString();
    }
}

Imports System

Namespace ca1721

    Public Class Test

        Public ReadOnly Property [Date]() As DateTime
            Get
                Return DateTime.Today
            End Get
        End Property

        ' Violates rule: PropertyNamesShouldNotMatchGetMethods.
        Public Function GetDate() As String
            Return Me.Date.ToString()
        End Function

    End Class

End Namespace