CA1512: Använd throw-helper-funktionen för ArgumentOutOfRangeException

Egenskap Värde
Regel-ID CA1512
Title Använda hjälpen för ArgumentOutOfRangeException-kast
Kategori Underhåll
Korrigeringen är antingen invasiv eller icke-invasiv Nobrytande
Aktiverad som standard i .NET 10 Som förslag
Tillämpliga språk C# och Visual Basic

Orsak

Koden kontrollerar om ett argument är mindre än eller större än ett angivet värde och sedan villkorligt genererar en ArgumentOutOfRangeException.

Regelbeskrivning

Argumentkontroller har en betydande inverkan på kodstorleken och dominerar ofta koden för små funktioner och egenskapsuppsättningar. Dessa kontroller förhindrar inlining och orsakar betydande kontaminering av instruktionscachen. Throw-helper-metoder som ArgumentOutOfRangeException.ThrowIfGreaterThan är enklare och effektivare än if block som konstruerar en ny undantagsinstans.

Exempel

Följande kodfragment visar överträdelser av 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));
}

Följande kodfragment visar korrigeringarna:

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);
}

Så här åtgärdar du överträdelser

Ersätt blocket if som utlöser undantaget med ett anrop till någon av följande throw-helper-metoder:

I Visual Studio kan du också använda glödlampans meny för att korrigera koden automatiskt.

När du ska ignorera varningar

Det är säkert att förhindra en överträdelse av den här regeln om du inte bryr dig om kodens underhållbarhet. Det är också bra att undertrycka överträdelser som identifieras som falska positiva.

Ignorera en varning

Om du bara vill förhindra en enda överträdelse lägger du till förprocessordirektiv i källfilen för att inaktivera och aktiverar sedan regeln igen.

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

Om du vill inaktivera regeln för en fil, mapp eller ett projekt anger du dess allvarlighetsgrad till none i konfigurationsfilen.

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

Mer information finns i Så här utelämnar du kodanalysvarningar.

  • Last updated on