Bij CA1512: gebruik maken van de throw helper voor ArgumentOutOfRangeException

Eigenschap Waarde
Regel-id CA1512
Titel Gebruik de hulpfunctie voor het gooien van een ArgumentOutOfRangeException.
Categorie Onderhoudbaarheid
Fix kan brekend of niet-brekend zijn Onbreekbaar
Standaard ingeschakeld in .NET 10 Als suggestie
Toepasselijke talen C# en Visual Basic

Oorzaak

Code controleert of een argument kleiner of groter is dan een bepaalde waarde en vervolgens voorwaardelijk een ArgumentOutOfRangeException.

Beschrijving van regel

Argumentcontroles hebben een aanzienlijke invloed op de codegrootte en bepalen vaak de code voor kleine functies en eigenschappensetters. Deze controles verhinderen inlining en veroorzaken aanzienlijke vervuiling van de instructiecache. Throw-helper-methoden, zoals ArgumentOutOfRangeException.ThrowIfGreaterThan, zijn eenvoudiger en efficiënter dan if-blokken die een nieuwe uitzonderingsinstantie maken.

Voorbeeld

In het volgende codefragment ziet u schendingen van CA1512:

void M(int arg)
{
    if (arg is 0)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg < 0)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg <= 0)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg <= 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg < 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg > 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg >= 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg == 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg != 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
}

In het volgende codefragment ziet u de oplossingen:

void M(int arg)
{
    ArgumentOutOfRangeException.ThrowIfZero(arg);
    ArgumentOutOfRangeException.ThrowIfNegative(arg);
    ArgumentOutOfRangeException.ThrowIfNegativeOrZero(arg);
    ArgumentOutOfRangeException.ThrowIfLessThanOrEqual(arg, 42);
    ArgumentOutOfRangeException.ThrowIfLessThan(arg, 42);
    ArgumentOutOfRangeException.ThrowIfGreaterThan(arg, 42);
    ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(arg, 42);
    ArgumentOutOfRangeException.ThrowIfEqual(arg, 42);
    ArgumentOutOfRangeException.ThrowIfNotEqual(arg, 42);
}

Hoe schendingen op te lossen

Vervang het if blok dat de uitzondering genereert door een aanroep naar een van de volgende throw-helpermethoden:

Of gebruik in Visual Studio het gloeilampmenu om uw code automatisch te herstellen.

Wanneer waarschuwingen onderdrukken

Het is veilig om een schending van deze regel te onderdrukken als u zich geen zorgen maakt over de onderhoudbaarheid van uw code. Het is ook prima om schendingen te onderdrukken die worden geïdentificeerd als vals-positieven.

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

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

Zie voor meer informatie Hoe codeanalysewaarschuwingen te onderdrukken.

  • Last updated on