CKTIS / C#
Boxing e unboxing de valores em C#
Aprende quando o C# copia um valor para um objeto, por que motivo o unboxing exige que o tipo corresponda e que exceção resulta de cada erro.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
object boxed = value; // value has a boxable value type T
T copy = (T)boxed; // T is the original non-nullable value type
T? optional = (T?)boxed; // also accepts null and yields an empty T?O boxing converte implicitamente um valor como int em object ou num tipo de interface implementado pelo seu tipo. O ambiente de execução normalmente aloca um objeto na heap gerida para guardar uma cópia do valor. Alterar depois a variável original não altera essa cópia. O boxing frequente pode aumentar a carga sobre o coletor de lixo; List<int> guarda os elementos sem boxing.
O unboxing é uma conversão explícita que verifica o tipo do valor guardado e extrai uma cópia. Para um tipo de valor de destino que não admite null, a regra de C# exige uma correspondência exata. Se boxed contiver um int, (int)boxed funciona, mas (long)boxed lança InvalidCastException, mesmo se o número for representável como long. Em long widened = (int)boxed;, a conversão explícita extrai primeiro o int e a atribuição converte-o depois implicitamente em long.
O unboxing de uma referência null para um tipo que não admite null, como int, lança NullReferenceException. Se a referência não for null mas não apontar para um objeto compatível, é lançada InvalidCastException.
O boxing de T? é diferente: se HasValue for verdadeiro, é feito o boxing do valor subjacente de tipo T, não da instância de T?. Caso contrário, o resultado é uma referência null e não é alocado nenhum objeto. O unboxing para T? devolve um valor vazio para null ou um valor que contém T para um T sujeito a boxing. Um objeto incompatível continua a causar InvalidCastException.
Exemplos
#nullable enable
using System;
int source = 42;
object boxed = source;
source = 7;
Console.WriteLine(FormattableString.Invariant($"source={source}; boxed={(int)boxed}"));
long widened = (int)boxed;
Console.WriteLine(FormattableString.Invariant($"widened={widened}"));
try
{
_ = (long)boxed;
}
catch (InvalidCastException)
{
Console.WriteLine(nameof(InvalidCastException));
}
object? empty = (int?)null;
try
{
_ = (int)empty!;
}
catch (NullReferenceException)
{
Console.WriteLine(nameof(NullReferenceException));
}
int? present = (int?)boxed;
int? absent = (int?)empty;
Console.WriteLine(FormattableString.Invariant($"nullable value={present}; empty HasValue={absent.HasValue}"));Resultado
source=7; boxed=42 widened=42 InvalidCastException NullReferenceException nullable value=42; empty HasValue=False
Alterar `source` para `7` não modifica o `42` guardado. O `!` em `empty!` apenas suprime o aviso do compilador sobre um possível `null`; não altera o valor nem impede a exceção.
Lições relacionadas
- C# · Lição 37 · Intermédio · Versão: 2