Freigeben über

Explizite Umwandlung hinzufügen (IDE0221)

Eigentum Wert
Regel-ID IDE0221
Title Hinzufügen einer expliziten Umwandlung
Kategorie Stil
Unterkategorie Sprachregeln (Präferenzen auf Ausdrucksebene)
Anwendbare Sprachen C#
Options dotnet_style_prefer_non_hidden_explicit_cast_in_source

Übersicht

Diese Regel kennzeichnet explizite Umwandlungen im Quellcode, bei denen der Compiler eine zusätzliche, nicht sichtbare explizite Umwandlung hinzufügt. Sowohl die sichtbaren als auch ausgeblendeten Umwandlungen können aus unterschiedlichen Gründen zur Laufzeit fehlschlagen. Wenn diese Regel solchen Code kennzeichnet, wird empfohlen, die Zwischencast explizit im Quellcode hinzuzufügen, um die Absicht des Codes klarer zu machen.

Wenn Sie beispielsweise (Derived)x schreiben, wo x von einem Typ ist, der zwei explizite Umwandlungen erfordert – zuerst zu einem Basistyp und dann zu einem abgeleiteten Typ – ist nur eine Umwandlung im Quellcode sichtbar. Der Compiler fügt den Zwischenguss ohne Angabe in die Quelle ein. Diese Regel schlägt vor, beide Umwandlungen explizit zu schreiben: (Derived)(Base)x.

Options

Optionen geben das Verhalten an, das die Regel erzwingen soll. Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

dotnet_style_prefer_non_hidden_explicit_cast_in_source

Eigentum Wert Beschreibung
Name der Option dotnet_style_prefer_non_hidden_explicit_cast_in_source
Optionswerte true Bevorzugen Sie es, alle expliziten Zwischenumwandlungen im Quellcode sichtbar zu machen.
false Bevorzugen Sie nicht, alle zwischengeschalteten expliziten Umwandlungen im Quellcode sichtbar zu machen.
Standardwert der Option true

Beispiel

class Base { }
class Derived : Base { }

class Castable
{
    public static explicit operator Base(Castable c) => new Base();
}

class C
{
    void M()
    {
        // Code with violation: the compiler inserts a hidden (Base) cast.
        var v = (Derived)new Castable();

        // Fixed code: both casts are explicit in source.
        var v2 = (Derived)(Base)new Castable();
    }
}

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut zu aktivieren.

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

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad auf none in der Konfigurationsdatei fest.

[*.cs]
dotnet_diagnostic.IDE0221.severity = none

Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie Style auf none in der Konfigurationsdatei fest.

[*.cs]
dotnet_analyzer_diagnostic.category-Style.severity = none

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Siehe auch

  • Last updated on