Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Explicitní přetypování: (T)expression

Výraz `(T)expression` explicitně převede výsledek výrazu `expression` na typ `T`. Může jít o číselnou konverzi, konverzi reference, unboxing nebo uživatelsky definovanou konverzi. Úspěch není zaručen: může dojít ke ztrátě dat nebo vyvolání výjimky.

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

Syntaxe

(T)expression

Výraz (T)expression požaduje explicitní konverzi: T je cílový typ a expression poskytuje převáděnou hodnotu. Přetypování může požadovat také konverzi, která je dostupná implicitně. Pokud neexistuje použitelná konverze, kompilátor kód odmítne; přidání (T) neumožňuje libovolné převody mezi typy.

Číselné konverze mohou vést ke ztrátě informací. U konečné hodnoty double, jejíž celočíselná část se vejde do int, výraz (int)value zahodí desetinnou část směrem k nule: -12.75 se změní na -12, nikoli na -13. Při zužující konverzi mezi celočíselnými typy v kontextu checked konverze vyvolá výjimku OverflowException, pokud hodnota zjištěná za běhu leží mimo rozsah cílového typu. Je-li operand konstantní výraz s hodnotou mimo tento rozsah, konverze v kontextu checked způsobí chybu při kompilaci, například u checked((byte)256). V kontextu unchecked taková zužující konverze zahodí přebytečné bity. Toto pravidlo nelze zobecnit na všechny číselné konverze.

Konverze reference nemění objekt ani jeho běhový typ. Přetypování nekompatibilního objektu může vyvolat InvalidCastException; přetypování reference null na referenční typ stále vrátí null. Pokud zdrojová reference není null, unboxing vyžaduje zabalenou hodnotu odpovídajícího typu: pokud boxed obsahuje int, výraz (long)boxed vyvolá InvalidCastException, ale (long)(int)boxed nejprve rozbalí int a potom jej převede na long. Unboxing reference null na hodnotový typ s podporou null dává null: například (int?)(object)null dává null typu int?, aniž by existovala zabalená hodnota.

Na rozdíl od přetypování is ověřuje kompatibilitu, zatímco as při nekompatibilitě vrátí null a nepodporuje číselné ani uživatelsky definované konverze. Typ může definovat konverzní operátory implicit a explicit, které přetypování používá; samotný operátor () přetížit nelze. Příklad ukazuje odříznutí desetinné části, unboxing následovaný rozšířením a konverzi reference.

Příklady

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

Výsledek

-12
42
5

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje