Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Conversão explícita de tipo: (T)expression

A expressão `(T)expression` converte explicitamente o resultado de `expression` para o tipo `T`. Pode efetuar uma conversão numérica ou de referência, unboxing ou uma conversão definida pelo utilizador. O sucesso não é garantido: pode perder dados ou lançar uma exceção.

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

Sintaxe

(T)expression

A expressão (T)expression pede uma conversão explícita: T é o tipo de destino e expression fornece o valor a converter. Um cast também pode pedir uma conversão que esteja disponível implicitamente. Se não existir uma conversão aplicável, o compilador rejeita o código; acrescentar (T) não permite conversões arbitrárias entre tipos.

As conversões numéricas podem perder informação. Para um double finito cuja parte inteira caiba num int, (int)value descarta a parte fracionária em direção a zero: -12.75 passa a -12, não a -13. Ao converter para um tipo inteiro de menor amplitude num contexto checked, a conversão lança OverflowException se o valor inteiro obtido em tempo de execução estiver fora do intervalo do tipo de destino. Se o operando for uma expressão constante cujo valor esteja fora desse intervalo, a conversão num contexto checked provoca um erro de compilação, como em checked((byte)256). Num contexto unchecked, este tipo de conversão descarta os bits excedentes. Não generalize esta regra a todas as conversões numéricas.

Uma conversão de referência não altera o objeto nem o respetivo tipo em tempo de execução. Fazer cast de um objeto incompatível pode lançar InvalidCastException; fazer cast de uma referência null para um tipo de referência continua a produzir null. Se a referência de origem não for null, o unboxing exige um valor do tipo adequado que tenha sido sujeito a boxing: se boxed contiver um int, (long)boxed lança InvalidCastException, mas (long)(int)boxed primeiro desempacota o int e depois converte-o para long. Uma conversão de unboxing de uma referência null para um tipo de valor que admite null dá null: por exemplo, (int?)(object)null dá null do tipo int? sem que exista qualquer valor sujeito a boxing.

Ao contrário de um cast, is verifica a compatibilidade, enquanto as devolve null em caso de incompatibilidade e não suporta conversões numéricas nem definidas pelo utilizador. Um tipo pode definir os operadores de conversão implicit e explicit usados pelos casts; não pode sobrecarregar o próprio (). O exemplo mostra o truncamento da parte fracionária, o unboxing seguido de uma conversão para um tipo mais abrangente e uma conversão de referência.

Exemplos

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

Resultado

-12
42
5

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes