Conversión boxing y unboxing (Guía de programación de C#)

  • Artículo

Actualización: Julio de 2008

La conversión boxing es el proceso de convertir Tipos de valores (Referencia de C#) en el tipo object o en cualquier tipo de interfaz implementado por este tipo de valor. Cuando CLR aplica la conversión boxing a un tipo de valor, ajusta el valor dentro de un elemento System.Object y lo almacena en el montón administrado. La conversión unboxing extrae el tipo de valor del objeto. En el ejemplo siguiente, se aplica la conversión boxing a la variable de tipo entero i y esta se asigna al objeto o.

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

A continuación, se puede aplicar la conversión unboxing al objeto o y asignarlo a la variable de entero i:

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

Rendimiento

Con relación a las asignaciones simples, las conversiones boxing y unboxing son procesos que consumen muchos recursos. Cuando se aplica la conversión boxing a un tipo de valor, se debe asignar y construir un objeto completamente nuevo. En menor grado, la conversión de tipos requerida para aplicar la conversión unboxing también es costosa. Para obtener más información, vea Rendimiento (Guía de programación de C#).

Boxing

La conversión boxing se utiliza para almacenar tipos de valor en el montón de recolección de elementos no utilizados. Boxing es una conversión implícita de Tipos de valores (Referencia de C#) al tipo object o a cualquier tipo de interfaz implementado por este tipo de valor. Al aplicar la conversión boxing a un tipo de valor se asigna una instancia de objeto en el montón y copia el valor en el nuevo objeto.

Considere la siguiente declaración de una variable de tipo de valor:

int i = 123;

La siguiente instrucción aplica implícitamente la operación de boxing sobre la variable i:

object o = i;  // Implicit boxing

El resultado de esta instrucción es crear una referencia de objeto o en la pila que hace referencia a un valor del tipo int en el montón. Este valor es una copia del valor del tipo de valor asignado a la variable i. La diferencia entre las dos variables, i y o, se muestra en la siguiente ilustración.

Conversión Boxing

También es posible realizar la conversión boxing de manera explícita, tal como se muestra en el ejemplo siguiente, pero ésta nunca es necesaria:

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

Descripción

Este ejemplo convierte una variable de entero i en un objeto o mediante la conversión boxing. A continuación, el valor almacenado en la variable i se cambia de 123 a 456. El ejemplo muestra que el tipo de valor original y el objeto empaquetado usan ubicaciones de memoria independientes y, por consiguiente, pueden almacenar valores diferentes.

Ejemplo

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

        i = 456;  // Change the contents of i

        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
*/

El ejemplo siguiente muestra un caso de conversión unboxing no válida y la excepción InvalidCastExceptionresultante. Si se utiliza try y catch, se muestra un mensaje de error cuando se produce el error.

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 produce el siguiente resultado:

Specified cast is not valid. Error: Incorrect unboxing.

Si cambia la instrucción:

int j = (short) o;

a:

int j = (int) o;

la conversión se realizará y se obtendrá el resultado:

Unboxing OK.

Unboxing

Unboxing es una conversión explícita del tipo object a un tipo de valor o de un tipo de interfaz a un tipo de valor que implementa la interfaz. Una operación de unboxing consiste en:

  • Comprobar la instancia de objeto para asegurar que se trata de un valor de conversión boxing del tipo de valor dado.

  • Copiar el valor de la instancia en la variable de tipo de valor.

Las siguientes instrucciones muestran las operaciones de boxing y unboxing:

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

En la ilustración siguiente se muestra el resultado de las instrucciones anteriores.

Conversión Unboxing

Para que la conversión Unboxing de tipos de valores sea correcta en tiempo de ejecución, el elemento al que se aplica debe ser una referencia a un objeto creado previamente mediante la conversión Boxing de una instancia de dicho tipo de valor. Si se intenta aplicar la conversión unboxing a null o una referencia a un tipo de valor incompatible, se producirá una excepción InvalidCastException.

Especificación del lenguaje C#

Para obtener más información, vea las siguientes secciones de Especificación del lenguaje C#.

  • 4.3.1 Conversiones boxing

Secciones relacionadas

Para obtener más información:

Especificación del lenguaje C#

Para obtener más información, vea la sección siguiente de Especificación del lenguaje C#.

  • 4.3 Conversiones boxing y unboxing

Vea también

Conceptos

Guía de programación de C#

Historial de cambios

Fecha

Historial

Motivo

Julio de 2008

Se consolidan en este tema los temas sobre conversión boxing y unboxing antes separados.

Corrección de errores de contenido.