Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Jawne rzutowanie typu: (T)expression

Wyrażenie `(T)expression` jawnie konwertuje wynik `expression` do typu `T`. Może wykonywać konwersję liczbową, referencyjną, rozpakowanie lub konwersję zdefiniowaną przez użytkownika. Nie gwarantuje powodzenia: może utracić dane albo zgłosić wyjątek.

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

Składnia

(T)expression

Wyrażenie (T)expression oznacza jawną konwersję: T jest typem docelowym, a expression wyrażeniem, którego wynik ma zostać skonwertowany. Rzutowanie może także wskazać konwersję dostępną niejawnie. Jeśli odpowiednia konwersja nie istnieje, kompilator odrzuci kod; samo dodanie (T) nie umożliwia dowolnej zamiany typów.

Konwersje liczbowe mogą tracić informacje. Dla skończonej wartości double, której część całkowita mieści się w int, (int)value odrzuca część ułamkową w kierunku zera: -12.75 daje -12, a nie -13. Przy zawężaniu między typami całkowitymi w kontekście checked wartość spoza zakresu ustalona w czasie wykonywania powoduje zgłoszenie OverflowException. Jeśli operand jest wyrażeniem stałym o wartości spoza zakresu typu docelowego, konwersja w kontekście checked jest błędem kompilacji, jak w checked((byte)256). W kontekście unchecked taka konwersja zawężająca odrzuca nadmiarowe bity. Nie należy uogólniać tej reguły na wszystkie konwersje liczbowe.

Konwersja referencyjna nie zmienia obiektu ani jego rzeczywistego typu. Rzutowanie niezgodnego obiektu może zgłosić InvalidCastException; rzutowanie referencji null na typ referencyjny nadal daje null. Jeśli referencja źródłowa nie jest null, rozpakowanie wymaga zapakowanej wartości odpowiedniego typu: jeśli boxed zawiera int, (long)boxed zgłosi InvalidCastException, ale (long)(int)boxed najpierw rozpakuje int, a potem skonwertuje go na long. Konwersja rozpakowująca referencji null na typ wartościowy dopuszczający null daje null: na przykład (int?)(object)null daje null typu int?, choć nie ma żadnej zapakowanej wartości.

W odróżnieniu od rzutowania is sprawdza zgodność, a as zwraca null przy niezgodności i nie obsługuje konwersji liczbowych ani zdefiniowanych przez użytkownika. Typ może definiować operatory konwersji implicit i explicit używane przez rzutowanie; nie przeciąża się samego (). Przykład pokazuje obcięcie części ułamkowej, rozpakowanie z późniejszym poszerzeniem oraz konwersję referencyjną.

Przykłady

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

Wynik

-12
42
5

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła