CA1512: Az ArgumentOutOfRangeException dobássegítő használata

Tulajdonság Érték
Szabályazonosító CA1512
Cím Az ArgumentOutOfRangeException dobássegítő használata
Kategória Fenntarthatóság
A javítás romboló vagy nem romboló Nem törhető
Alapértelmezés szerint engedélyezve a .NET 10-ben Javaslatként
Alkalmazandó nyelvek C# és Visual Basic

Ok

A kód ellenőrzi, hogy egy argumentum kisebb vagy nagyobb-e egy adott értéknél, majd feltételesen ArgumentOutOfRangeException.

Szabály leírása

Az argumentum-ellenőrzések jelentős hatással vannak a kód méretére, és gyakran uralják a kis függvények és a tulajdonsághalmazok kódját. Ezek az ellenőrzések megakadályozzák az inlinelést, és jelentős utasítás-cache szennyezést okoznak. A dobássegítő módszerek, például ArgumentOutOfRangeException.ThrowIfGreaterThan egyszerűbbek és hatékonyabbak, mint if az új kivételpéldányt építő blokkok.

Példa

A következő kódrészlet a CA1512 megsértését mutatja be:

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

A következő kódrészlet a javításokat mutatja be:

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

Szabálysértések kijavítása

Cserélje le a if kivételt okozó blokkot a következő kivételkezelő segédfüggvények egyikének meghívásával:

Vagy a Visual Studióban a villanykörte menü használatával automatikusan kijavíthatja a kódot.

Mikor kell letiltani a figyelmeztetéseket?

Ha nem aggódik a kód karbantarthatósága miatt, nyugodtan letilthatja a szabály megsértését. Rendben van az is, ha figyelmen kívül hagyja a hamis pozitívnak minősített szabálysértéseket.

Figyelmeztetés mellőzése

Ha csak egyetlen szabálysértést szeretne letiltani, adjon hozzá előfeldolgozási irányelveket a forrásfájlhoz a szabály letiltásához és újbóli engedélyezéséhez.

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

Ha le szeretné tiltani egy fájl, mappa vagy projekt szabályát, állítsa annak súlyosságát none a konfigurációs fájlban.

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

További információ: Kódelemzési figyelmeztetések letiltása.

  • Last updated on