Share via

CA1711: Id's mogen geen onjuist achtervoegsel hebben

  • Artikel
Eigendom Waarde
Regel-id CA1711
Titel Id's mogen geen onjuist achtervoegsel hebben
Categorie Naamgeving
Oplossing is onderbrekend of niet-onderbrekend Onderbreken
Standaard ingeschakeld in .NET 9 Nee

Oorzaak

Een identificator heeft een verkeerd achtervoegsel.

Deze regel kijkt standaard alleen naar extern zichtbare id's, maar dit kan worden geconfigureerd.

Beschrijving van regel

Volgens de conventie moeten alleen de namen van typen die bepaalde basistypen uitbreiden of bepaalde interfaces implementeren, of typen die zijn afgeleid van deze typen, eindigen met specifieke gereserveerde achtervoegsels. Andere typenamen mogen deze gereserveerde achtervoegsels niet gebruiken.

De volgende tabel bevat de gereserveerde achtervoegsels en de basistypen en interfaces waaraan ze zijn gekoppeld.

Achtervoegsel Basistype/interface
Attribute System.Attribute
Collection System.Collections.ICollection

System.Collections.IEnumerable

System.Collections.Queue

System.Collections.Stack

System.Collections.Generic.ICollection<T>

System.Data.DataSet

System.Data.DataTable
Dictionary System.Collections.IDictionary

System.Collections.Generic.IDictionary<TKey,TValue>
EventArgs System.EventArgs
EventHandler Een evenementafhandelaar-gedelegeerde
Exception System.Exception
Permission System.Security.IPermission
Queue System.Collections.Queue
Stack System.Collections.Stack
Stream System.IO.Stream

Bovendien mogen de volgende achtervoegsels niet worden gebruikt:

  • Delegate
  • Enum
  • Ex of vergelijkbaar achtervoegsel om het te onderscheiden van een eerdere versie van hetzelfde type
  • Flag of Flags voor opsommingstypen
  • Impl (gebruik Core in plaats daarvan)
  • New als een lid met dezelfde naam maar zonder het New achtervoegsel al bestaat

Naamconventies bieden een gemeenschappelijk uiterlijk voor bibliotheken die gericht zijn op de .NET Common Language Runtime. Deze conventies verminderen de leercurve die nodig is voor nieuwe softwarebibliotheken en vergroten het vertrouwen van klanten dat de bibliotheek is ontwikkeld door iemand met expertise in het ontwikkelen van beheerde code. Zie Naamgevingsrichtlijnen: Klassen, Structs en Interfaces voor meer informatie.

Hoe overtredingen te verhelpen

Verwijder het achtervoegsel uit de typenaam.

Wanneer waarschuwingen onderdrukken

Onderdrukt geen waarschuwing van deze regel, tenzij het achtervoegsel een ondubbelzinnige betekenis heeft in het toepassingsdomein.

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

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

Voor meer informatie, zie Codeanalysewaarschuwingen onderdrukken.

Code configureren om te analyseren

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

U kunt deze opties configureren voor alleen deze regel, voor alle regels waarop ze van toepassing zijn, of voor alle regels in deze categorie (Naamgeving) waarop ze van toepassing zijn. Zie de configuratieopties voor de codekwaliteitsregel voor meer informatie.

Specifieke API-oppervlakken opnemen

U kunt configureren op welke onderdelen van uw codebase deze regel moet worden uitgevoerd, op basis van hun toegankelijkheid, door de optie api_surface in te stellen. 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

Notitie

Vervang het XXXX deel van CAXXXX door de id van de toepasselijke regel.

Achtervoegsels toestaan

U kunt een lijst met toegestane achtervoegsels configureren, waarbij elk achtervoegsel wordt gescheiden door het pipeteken (|). Als u bijvoorbeeld wilt opgeven dat de regel niet mag worden uitgevoerd op vlag- en vlaggenachtervoegsels, voegt u het volgende sleutel-waardepaar toe aan een .editorconfig-bestand in uw project:

dotnet_code_quality.ca1711.allowed_suffixes = Flag|Flags

Zie ook