Conversões boxing e unboxing (Guia de Programação em C#)

Conversão boxing é o processo de conversão de um tipo de valor para o tipo object ou para qualquer tipo de interface implementada por esse tipo de valor. Quando as caixas de Common Language Runtime (CLR) um tipo de valor, ele encapsula o valor dentro de uma System.Object instância e a armazena no heap gerenciado. A conversão unboxing extrai o tipo de valor do objeto. A conversão boxing é implícita, a conversão unboxing é explícita. O conceito de conversões boxing e unboxing serve como base para a exibição unificada de C# do sistema de tipos em que um valor de qualquer tipo pode ser tratado como um objeto.

No exemplo a seguir, a variável de inteiro i é submetida à conversão boxing e atribuída ao objeto o.

int i = 123;
// The following line boxes i.
object o = i;

O objeto o pode ser submetido à conversão unboxing e atribuído à variável de inteiro i:

o = 123;
i = (int)o;  // unboxing

Os exemplos a seguir ilustram como a conversão boxing é usada em C#.

byte[] array = { 0x64, 0x6f, 0x74, 0x63, 0x65, 0x74 };

string hexValue = Convert.ToHexString(array);
Console.WriteLine(hexValue);

/*Output:
  646F74636574
 */

Desempenho

Em relação às atribuições simples, as conversões boxing e unboxing são processos computacionalmente dispendiosos. Quando um tipo de valor é submetido à conversão boxing, um novo objeto deve ser alocado e construído. A um grau menor, a conversão necessária para a conversão unboxing também é computacionalmente dispendiosa. Para obter mais informações, consulte Desempenho.

Conversão boxing

A conversão boxing é usada para armazenar tipos de valor no heap coletado como lixo. A conversão boxing é uma conversão implícita de um tipo de valor para o tipo object ou para qualquer tipo de interface implementada por esse tipo de valor. A conversão boxing de um tipo de valor aloca uma instância de objeto no heap e copia o valor no novo objeto.

Considere a seguinte declaração de uma variável de tipo de valor:

int i = 123;

A instrução a seguir aplica implicitamente a operação de conversão boxing na variável i:

// Boxing copies the value of i into object o.
object o = i;

O resultado dessa instrução é a criação de uma referência de objeto o, na pilha, que faz referência a um valor do tipo int, no heap. Esse valor é uma cópia do valor do tipo de valor atribuído à variável i. A diferença entre as duas variáveis, i e o, é ilustrada na figura de conversão boxing a seguir:

Gráfico mostrando a diferença entre variáveis i e o.

Também é possível executar a conversão boxing explicitamente como no exemplo a seguir, mas a conversão boxing explícita nunca é necessária:

int i = 123;
object o = (object)i;  // explicit boxing

Descrição

Este exemplo converte uma variável de inteiro i em um objeto o usando a conversão boxing. Em seguida, o valor armazenado na variável i é alterado de 123 para 456. O exemplo mostra que o tipo do valor original e o objeto submetido à conversão boxing usa locais de memória separados e, portanto, pode armazenar valores diferentes.

Exemplo

class TestBoxing
{
    static void Main()
    {
        int i = 123;

        // Boxing copies the value of i into object o.
        object o = i;

        // Change the value of i.
        i = 456;

        // The change in i doesn't affect the value stored in o.
        System.Console.WriteLine("The value-type value = {0}", i);
        System.Console.WriteLine("The object-type value = {0}", o);
    }
}
/* Output:
    The value-type value = 456
    The object-type value = 123
*/

Conversão unboxing

A conversão unboxing é uma conversão explícita do tipo object para um tipo de valor ou de um tipo de interface para um tipo de valor que implementa a interface. Uma operação de conversão unboxing consiste em:

  • Verificar a instância do objeto para garantir que ele é um valor da conversão boxing de um determinado tipo de valor.

  • Copiar o valor da instância para a variável de tipo de valor.

As instruções a seguir demonstram operações conversão boxing e unboxing:

int i = 123;      // a value type
object o = i;     // boxing
int j = (int)o;   // unboxing

A figura a seguir demonstra o resultado das instruções anteriores:

Gráfico mostrando uma conversão unboxing.

Para a conversão unboxing de tipos de valor ter êxito em tempo de execução, o item sendo submetido à conversão unboxing deve ser uma referência para um objeto que foi criado anteriormente ao realizar a conversão boxing de uma instância desse tipo de valor. Tentar realizar a conversão unboxing de null causa uma NullReferenceException. Tentar realizar a conversão unboxing de uma referência para um tipo de valor incompatível causa uma InvalidCastException.

Exemplo

O exemplo a seguir demonstra um caso de conversão unboxing inválida e o InvalidCastException resultante. Usando try e catch, uma mensagem de erro é exibida quando o erro ocorre.

class TestUnboxing
{
    static void Main()
    {
        int i = 123;
        object o = i;  // implicit boxing

        try
        {
            int j = (short)o;  // attempt to unbox

            System.Console.WriteLine("Unboxing OK.");
        }
        catch (System.InvalidCastException e)
        {
            System.Console.WriteLine("{0} Error: Incorrect unboxing.", e.Message);
        }
    }
}

Este programa produz:

Specified cast is not valid. Error: Incorrect unboxing.

Se você alterar a instrução:

int j = (short) o;

para:

int j = (int) o;

a conversão será executada e você receberá a saída:

Unboxing OK.

especificação da linguagem C#

Para obter mais informações, consulte a especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso de C#.

Veja também