Share via


Gebruiksregels

Gebruiksregels ondersteunen het juiste gebruik van .NET.

In deze sectie

Regel Beschrijving
CA1801: Ongebruikte parameters controleren Een methodehandtekening bevat een parameter die niet wordt gebruikt in de hoofdtekst van de methode.
CA1816: Bel GC. SuppressFinalize correct Een methode die een implementatie van Dispose is, roept geen aan, GC.SuppressFinalizeof een methode die geen implementatie van Dispose aanroepen GC.SuppressFinalizeis, of een methodeaanroepen GC.SuppressFinalize en geeft iets anders dan this (Me in Visual Basic) door.
CA2200: Opnieuw verzamelen om stackdetails te behouden Er wordt een uitzondering opnieuw gestart en de uitzondering wordt expliciet opgegeven in de throw-instructie. Als een uitzondering opnieuw wordt uitgevoerd door de uitzondering in de throw-instructie op te geven, wordt de lijst met methodeaanroepen tussen de oorspronkelijke methode die de uitzondering heeft veroorzaakt en de huidige methode verloren gegaan.
CA2201: geen gereserveerde uitzonderingstypen genereren Hierdoor is de oorspronkelijke fout moeilijk te detecteren en fouten op te sporen.
CA2207: Waardetype statische velden inline initialiseren Een waardetype declareert een expliciete statische constructor. Als u een schending van deze regel wilt oplossen, initialiseert u alle statische gegevens wanneer deze wordt gedeclareerd en verwijdert u de statische constructor.
CA2208: Argument-uitzonderingen op de juiste manier instantiëren Er wordt een aanroep uitgevoerd naar de standaardconstructor (parameterloos) van een uitzonderingstype dat afkomstig is of is afgeleid van ArgumentException, of een onjuist tekenreeksargument wordt doorgegeven aan een geparameteriseerde constructor van een uitzonderingstype dat is of is afgeleid van ArgumentException.
CA2211: Niet-constante velden mogen niet zichtbaar zijn Statische velden die geen constanten of alleen-lezen zijn, zijn niet thread-veilig. Toegang tot een dergelijk veld moet zorgvuldig worden beheerd en vereist geavanceerde programmeertechnieken voor het synchroniseren van de toegang tot het klasseobject.
CA2213: Wegwerpvelden moeten worden verwijderd Een type waarmee velden worden geïmplementeerd System.IDisposable , declareert velden die ook worden geïmplementeerd IDisposable. De Dispose methode van het veld wordt niet aangeroepen door de Dispose methode van het declaratietype.
CA2214: Geen overschrijfbare methoden in constructors aanroepen Wanneer een constructor een virtuele methode aanroept, is het mogelijk dat de constructor voor het exemplaar dat de methode aanroept, niet is uitgevoerd.
CA2215: Verwijderingsmethoden moeten de basisklasse verwijderen aanroepen Als een type overneemt van een wegwerptype, moet het de Dispose methode van het basistype van een eigen Dispose methode aanroepen.
CA2216: Wegwerptypen moeten finalizer declareren Een type dat implementeert System.IDisposableen velden bevat die het gebruik van onbeheerde resources voorstellen, implementeert geen finalizer zoals beschreven door Object.Finalize.
CA2217: Opsommingen niet markeren met FlagsAttribute Een extern zichtbare opsomming wordt gemarkeerd met FlagsAttributeen heeft een of meer waarden die geen bevoegdheden hebben van twee of een combinatie van de andere gedefinieerde waarden in de opsomming.
CA2218: GetHashCode overschrijven bij het overschrijven van Equals Een openbaar type wordt overschreven System.Object.Equals , maar wordt niet overschreven System.Object.GetHashCode.
CA2219: Geen uitzonderingen genereren in uitzonderingsclausules Wanneer een uitzondering wordt gegenereerd in een laatste of foutcomponent, verbergt de nieuwe uitzondering de actieve uitzondering. Wanneer er een uitzondering wordt gegenereerd in een filtercomponent, wordt de uitzondering op de achtergrond door de runtime onderschept. Hierdoor is de oorspronkelijke fout moeilijk te detecteren en fouten op te sporen.
CA2224: Onderdrukking is gelijk aan overbelastingsoperator is gelijk aan Een openbaar type implementeert de gelijkheidsoperator, maar overschrijft System.Object.Equalsdeze niet.
CA2225: Overbelastingen van operatoren hebben alternatieve namen Er is een overbelasting van de operator gedetecteerd en de verwachte alternatieve methode is niet gevonden. Het benoemde alternatieve lid biedt toegang tot dezelfde functionaliteit als de operator en wordt geleverd voor ontwikkelaars die programma's uitvoeren in talen die geen overbelaste operators ondersteunen.
CA2226: Operators moeten symmetrische overbelastingen hebben Een type implementeert de gelijkheids- of ongelijkheidsoperator en implementeert niet de tegenovergestelde operator.
CA2227: Verzamelingseigenschappen mogen alleen-lezen zijn Met een beschrijfbare verzamelingseigenschap kan een gebruiker de verzameling vervangen door een andere verzameling. Met een alleen-lezen eigenschap wordt de verzameling niet meer vervangen, maar kan de afzonderlijke leden nog steeds worden ingesteld.
CA2229: Serialisatieconstructors implementeren Als u een schending van deze regel wilt oplossen, implementeert u de serialisatieconstructor. Voor een verzegelde klasse maakt u de constructor privé; anders moet u deze beveiligen.
CA2231: De operator Overbelasting is gelijk aan het overschrijven van ValueType.Equals Een waardetype overschrijft, maar implementeert de gelijkheidsoperator Object.Equals niet.
CA2234: System.Uri-objecten doorgeven in plaats van tekenreeksen Er wordt een aanroep uitgevoerd naar een methode met een tekenreeksparameter waarvan de naam 'uri', 'URI', 'urn', 'URN', 'URL' of 'URL' bevat. Het declaratietype van de methode bevat een bijbehorende overbelasting van de methode die een System.Uri parameter heeft.
CA2235: alle niet-serialiseerbare velden markeren Een exemplaarveld van een type dat niet serialiseerbare is, wordt gedeclareerd in een type dat serialiseerbaar is.
CA2237: Mark ISerializable types with SerializableAttribute Om te worden herkend door de common language runtime als serializable, moeten typen worden gemarkeerd met het kenmerk SerializableAttribute, zelfs als het type een aangepaste serialisatieroutine gebruikt via de implementatie van de ISerializable interface.
CA2241: Geef de juiste argumenten op voor het opmaken van methoden Het doorgegeven String.Format opmaakargument bevat geen opmaakitem dat overeenkomt met elk objectargument of omgekeerd.
CA2242: Testen op NaN correct Met deze expressie wordt een waarde getest op Single.Nan of Double.Nan. Gebruik Single.IsNan(Single) of Double.IsNan(Double) test de waarde.
CA2243: Letterlijke kenmerktekenreeksen moeten correct worden geparseerd De letterlijke parameter tekenreeks van een kenmerk parseert niet correct voor een URL, een GUID of een versie.
CA2244: Initialisaties van geïndexeerde elementen niet dupliceren Een object-initialisatiefunctie heeft meer dan één geïndexeerde element-initialisatiefunctie met dezelfde constante index. De laatste initialisatiefunctie is echter overbodig.
CA2245: Wijs geen eigenschap toe aan zichzelf Er is per ongeluk een eigenschap aan zichzelf toegewezen.
CA2246: Wijs geen symbool en het bijbehorende lid toe aan dezelfde instructie Het toewijzen van een symbool en het bijbehorende lid, dat wil zeggen, een veld of eigenschap, in dezelfde instructie wordt niet aanbevolen. Het is niet duidelijk of de toegang tot het lid bedoeld is om de oude waarde van het symbool vóór de toewijzing of de nieuwe waarde van de toewijzing in deze instructie te gebruiken.
CA2247: Argument dat is doorgegeven aan taskcompletionSource-constructor, moet de enum TaskCreationOptions zijn in plaats van taskContinuationOptions-enum TaskCompletionSource heeft constructors die TaskCreationOptions gebruiken die de onderliggende taak beheren en constructors die de objectstatus overnemen die zijn opgeslagen in de taak. Als u per ongeluk een TaskContinuationOptions doorgeeft in plaats van een TaskCreationOptions, wordt de aanroep als status behandeld.
CA2248: Geef het juiste argument enum op voor 'Enum.HasFlag' Het enum-type dat als argument aan de HasFlag methodeaanroep wordt doorgegeven, verschilt van het aanroepende enum-type.
CA2249: Overweeg het gebruik van String.Contains in plaats van String.IndexOf Aanroepen naar string.IndexOf waar het resultaat wordt gebruikt om te controleren op de aanwezigheid of afwezigheid van een subtekenreeks kan worden vervangen door string.Contains.
CA2250: Gebruik ThrowIfCancellationRequested ThrowIfCancellationRequested controleert automatisch of het token is geannuleerd en genereert een OperationCanceledException als het is.
CA2251: Gebruiken String.Equals via String.Compare Het is zowel duidelijker als sneller te gebruiken String.Equals in plaats van het resultaat van String.Compare nul te vergelijken.
CA2252: Aanmelden voor preview-functies Meld u aan voor preview-functies voordat u preview-API's gebruikt.
CA2253: Benoemde tijdelijke aanduidingen mogen geen numerieke waarden zijn Benoemde tijdelijke aanduidingen in de sjabloon voor logboekregistratieberichten mogen niet bestaan uit alleen numerieke tekens.
CA2254: Sjabloon moet een statische expressie zijn De sjabloon voor logboekregistratieberichten mag niet per aanroep verschillen.
CA2255: Het ModuleInitializer kenmerk mag niet worden gebruikt in bibliotheken Module-initializers zijn bedoeld om te worden gebruikt door toepassingscode om ervoor te zorgen dat de onderdelen van een toepassing worden geïnitialiseerd voordat de toepassingscode wordt uitgevoerd.
CA2256: Alle leden die in bovenliggende interfaces zijn gedeclareerd, moeten een implementatie hebben in een DynamicInterfaceCastableImplementation-toegeschreven interface Typen die worden toegeschreven aan DynamicInterfaceCastableImplementationAttribute fungeren als een interface-implementatie voor een type dat het IDynamicInterfaceCastable type implementeert. Als gevolg hiervan moet het een implementatie bieden van alle leden die zijn gedefinieerd in de overgenomen interfaces, omdat het type dat wordt geïmplementeerd IDynamicInterfaceCastable , ze anders niet levert.
CA2257: Leden die zijn gedefinieerd op een interface met DynamicInterfaceCastableImplementationAttribute, moeten statisch zijn Aangezien een type dat wordt geïmplementeerd geen dynamische interface in metagegevens kan IDynamicInterfaceCastable implementeren, zullen aanroepen naar een exemplaarinterfacelid dat geen expliciete implementatie is die voor dit type is gedefinieerd, waarschijnlijk mislukken tijdens de uitvoering. Markeer nieuwe interfaceleden static om runtimefouten te voorkomen.
CA2258: Het leveren van een Interface DynamicInterfaceCastableImplementation in Visual Basic wordt niet ondersteund Voor het bieden van een functionele DynamicInterfaceCastableImplementationAttributeinterface is de functie Standaardinterfaceleden vereist. Deze functie wordt niet ondersteund in Visual Basic.
CA2259: Zorg ervoor dat ThreadStatic deze alleen wordt gebruikt met statische velden ThreadStaticAttribute is alleen van invloed op static (Shared in Visual Basic)-velden. Wanneer het kenmerk wordt toegepast op exemplaarvelden, heeft het kenmerk geen invloed op het gedrag.
CA2260: algemene wiskundige interfaces correct implementeren Voor algemene wiskundige interfaces moet het afgeleide type zelf worden gebruikt voor de zelf-terugkerende typeparameter.
CA2261: Niet gebruiken ConfigureAwaitOptions.SuppressThrowing met Task<TResult> De ConfigureAwaitOptions.SuppressThrowing optie wordt niet ondersteund door de algemene Task<TResult>, omdat dit kan leiden tot het retourneren van een ongeldige TResult.
CA2262: Juist instellen MaxResponseHeadersLength Zorg ervoor dat de MaxResponseHeadersLength waarde juist is opgegeven. Deze waarde wordt gemeten in kilobytes.
CA2264: Geef geen niet-null-waarde door aan 'ArgumentNullException.ThrowIfNull' 'ArgumentNullException.ThrowIfNull' genereert wanneer het doorgegeven argument null is. Bepaalde constructies zoals niet-null-structs en 'nameof()' en 'nieuwe' expressies zijn nooit null, dus 'ArgumentNullException.ThrowIfNull' wordt nooit gegooid.
CA2263: Voorkeur geven aan algemene overbelasting wanneer type bekend is Het gebruik van een algemene overbelasting verdient de voorkeur om een System.Type argument door te geven wanneer het type bekend is, omdat ze schonere en meer typeveilige code bevorderen met verbeterde compileertijdcontroles.