WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Explizite Typumwandlung: (T)expression

Der Ausdruck `(T)expression` konvertiert das Ergebnis von `expression` ausdrücklich in den Typ `T`. Dabei kann es sich um eine numerische oder Referenzkonvertierung, Unboxing oder eine benutzerdefinierte Konvertierung handeln. Der Erfolg ist nicht garantiert: Es können Daten verloren gehen oder Ausnahmen ausgelöst werden.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

(T)expression

Der Ausdruck (T)expression fordert eine explizite Konvertierung an: T ist der Zieltyp, und expression liefert den zu konvertierenden Wert. Ein Cast kann auch eine Konvertierung anfordern, die implizit verfügbar ist. Gibt es keine passende Konvertierung, weist der Compiler den Code zurück; (T) ermöglicht keine beliebigen Umwandlungen zwischen Typen.

Numerische Konvertierungen können Informationen verlieren. Bei einem endlichen double, dessen ganzzahliger Anteil in int passt, verwirft (int)value den Nachkommaanteil in Richtung null: Aus -12.75 wird -12, nicht -13. Bei einer verengenden Konvertierung zwischen Integer-Typen im checked-Kontext löst ein zur Laufzeit ermittelter Wert außerhalb des Zielbereichs OverflowException aus. Ist der Operand ein konstanter Ausdruck, dessen Wert außerhalb des Zielbereichs liegt, führt die Konvertierung im checked-Kontext zu einem Kompilierfehler, wie bei checked((byte)256). Im unchecked-Kontext verwirft eine solche verengende Konvertierung überschüssige Bits. Diese Regel gilt nicht allgemein für jede numerische Konvertierung.

Eine Referenzkonvertierung ändert weder das Objekt noch dessen Laufzeittyp. Das Casten eines inkompatiblen Objekts kann InvalidCastException auslösen; eine null-Referenz bleibt beim Casten auf einen Referenztyp null. Ist die Quellreferenz nicht null, erfordert Unboxing einen geboxten Wert des passenden Typs: Enthält boxed ein int, löst (long)boxed InvalidCastException aus. (long)(int)boxed entpackt dagegen zuerst den int und konvertiert ihn anschließend in long. Eine Unboxing-Konvertierung von einer null-Referenz in einen Nullable-Werttyp ergibt null: So liefert (int?)(object)null den Wert null vom Typ int?, ohne dass ein geboxt­er Wert vorliegt.

Im Unterschied zu einem Cast prüft is die Kompatibilität, während as bei Inkompatibilität null zurückgibt und keine numerischen oder benutzerdefinierten Konvertierungen unterstützt. Ein Typ kann die von Casts verwendeten Konvertierungsoperatoren implicit und explicit definieren; der Operator () selbst lässt sich nicht überladen. Das Beispiel zeigt das Abschneiden des Nachkommaanteils, Unboxing mit anschließender Erweiterung und eine Referenzkonvertierung.

Beispiele

using System;

internal static class Program
{
    private static void Main()
    {
        double value = -12.75;
        int whole = (int)value;
        Console.WriteLine(whole);

        object boxed = 42;
        long widened = (long)(int)boxed;
        Console.WriteLine(widened);

        object text = "hello";
        string word = (string)text;
        Console.WriteLine(word.Length);
    }
}

Ergebnis

-12
42
5

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen