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

CKTIS / C#

Conversões de tipos

As conversões permitem utilizar uma expressão como valor de outro tipo. Aprende como funcionam as conversões implícitas, os casts explícitos, o boxing e o unboxing. A especificação de C# exige uma correspondência exata de tipos no unboxing para um tipo de valor não anulável, mas o runtime do .NET também permite extrair um valor de enumeração como um valor do seu tipo inteiro subjacente. Segundo a especificação, um destino anulável aceita `null` ou um valor do tipo subjacente sujeito a boxing.

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

Sintaxe

Target implicitResult = expression;
Target explicitResult = (Target)expression;
object boxed = 42;
int unboxed = (int)boxed;
long widened = (long)(int)boxed;

Uma conversão permite tratar uma expressão como se tivesse um determinado tipo; pode alterar a representação do valor. Uma conversão implícita, como int → long, não requer um cast. Uma conversão explícita escreve-se como (Target)expression. Esta sintaxe, por si só, não garante o sucesso nem a preservação de todas as informações.

As conversões numéricas podem perder precisão: (int)19.75 produz 19, descartando a parte fracionária em direção a zero. Uma conversão de referência não copia o objeto nem altera o seu tipo em tempo de execução. Para ler números de texto, utiliza uma API como int.TryParse, não um cast.

Boxing e unboxing com correspondência exata do tipo (Boxing and exact-type unboxing): fazer boxing de um valor int normal para object guarda uma cópia num objeto na heap gerida. Alterações posteriores à variável de origem não alteram essa cópia. O unboxing é explícito: (int)boxed recupera o valor int boxed. (long)boxed gera InvalidCastException, apesar de existir uma conversão numérica de int → long. Utiliza (long)(int)boxed: primeiro faz unboxing e, depois, a conversão numérica.

Para escrever código portável, segue a regra da especificação de C#: no unboxing para um tipo de valor não anulável, o tipo de destino tem de corresponder exatamente ao tipo do valor sujeito a boxing. O runtime do .NET permite, contudo, extrair um valor de enumeração diretamente como um valor do seu tipo inteiro subjacente, como em (int)(object)DayOfWeek.Monday. Isto não significa que o unboxing faça conversões numéricas arbitrárias.

Fazer unboxing de null para um tipo de valor não anulável gera NullReferenceException. Os tipos anuláveis têm regras próprias: fazer boxing de um int? sem valor produz null; com valor, faz boxing de um int, não de um int?. Segundo a especificação, o unboxing para int? aceita null ou um int boxed.

Exemplos

using System;

int original = 42;
long widened = original;
int truncated = (int)19.75;
object boxed = original;
original = 99;

Console.WriteLine(widened);
Console.WriteLine(truncated);
Console.WriteLine((int)boxed);
Console.WriteLine((long)(int)boxed);

try
{
    long invalid = (long)boxed;
    Console.WriteLine(invalid);
}
catch (InvalidCastException)
{
    Console.WriteLine("InvalidCastException");
}

Resultado

42
19
42
42
InvalidCastException

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