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 die versteckten Umwandlungen können zur Laufzeit aus unterschiedlichen Gründen fehlschlagen. Wenn diese Regel einen solchen Code kennzeichnet, empfiehlt sie, die Zwischenumwandlung explizit in den Quellcode einzufügen, um die Absicht des Codes zu verdeutlichen.

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 die Zwischenumwandlung ein, ohne dass dies im Quellcode erkennbar ist. Diese Regel empfiehlt, 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 Ich möchte, dass alle expliziten Umwandlungen im Quellcode sichtbar sind.
false Ich möchte nicht, dass alle expliziten Umwandlungen im Quellcode sichtbar sind.
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