Conversión boxing (Extensiones de componentes de C++)

El compilador de Visual C++ puede convertir los tipos de valor en objetos con un proceso denominado conversión boxing y convierte los objetos en tipos de valor con un proceso denominado conversión unboxing.

Todos los runtimes

(No hay notas para esta característica de lenguaje que se aplican a todos los runtimes.)

Windows en tiempo de ejecución

C++/CX es compatible con una sintaxis abreviada para los tipos de valor de conversión boxing y los tipos de referencia de conversión unboxing.Se aplica la conversión boxing a un tipo de valor cuando se le asigna a una variable de tipo Object.A una variable Object se le aplica la conversión unboxing cuando se asigna a una variable de tipo de valor y el tipo al que se ha aplicado la conversión unboxing se especifica entre paréntesis; es decir, cuando la variable de objeto se convierte en el tipo de valor.

    Platform::Object^ object_variable  = value_variable;
    value_variable = (value_type) object_variable;

Requisitos

Opción del compilador: /ZW

Ejemplos

El siguiente ejemplo de código aplica la conversión boxing y unboxing a un valor DateTime.Primero, el ejemplo obtiene un valor DateTime que representa la fecha y hora actuales y lo asigna a una variable DateTime.Por consiguiente, a DateTime se le aplica la conversión boxing asignándolo a una variable de objeto.Finalmente, el valor al que se ha aplicado la conversión boxing es un valor con conversión unboxing asignándolo a otra variable DateTime

Para probar el ejemplo, cree un proyecto BlankApplication, reemplace el método BlankPage::OnNavigatedTo() y especifique los puntos de interrupción en el corchete de cierre y la asignación a la variable str1.Cuando el ejemplo alcance el corchete de cierre, examine str1.

void BlankPage::OnNavigatedTo(NavigationEventArgs^ e)
{
    using namespace Windows::Globalization::DateTimeFormatting;

    Windows::Foundation::DateTime dt, dtAnother;
    Platform::Object^ obj1;

    Windows::Globalization::Calendar^ c = 
        ref new Windows::Globalization::Calendar;
    c->SetToNow();
    dt = c->GetDateTime();
    auto dtf = ref new DateTimeFormatter(
                           YearFormat::Full, 
                           MonthFormat::Numeric, 
                           DayFormat::Default, 
                           DayOfWeekFormat::None);
    String^ str1 = dtf->Format(dt);
    OutputDebugString(str1->Data());
    OutputDebugString(L"\r\n");

    // Box the value type and assign to a reference type.
    obj1 = dt;
    // Unbox the reference type and assign to a value type.
    dtAnother = (Windows::Foundation::DateTime) obj1;

    // Format the DateTime for display.
    String^ str2 = dtf->Format(dtAnother);
    OutputDebugString(str2->Data());
}

Para obtener más información, vea Conversión boxing (C++/CX).

Common Language Runtime

El compilador de Visual C++ aplica la conversión boxing a los tipos de valor para Object.Esto es posible debido a una conversión definida por el compilador para convertir los tipos de valor en Object.

Las conversiones boxing y unboxing habilitan tipos de valor para que sean tratados como objetos.Los tipos de valor, incluidos tipos de struct los y tipos integrados como int, se pueden convertir al tipo Object y viceversa.

Para obtener más información, vea:

• Cómo: Explícitamente boxing de solicitud

• Cómo: Gcnew de uso para crear los tipos de valor y utilizar conversión Boxing implícita

• Cómo: Unbox

• Conversiones estándar e conversión Boxing implícita

Requisitos

Opción del compilador: /clr

Ejemplos

Ejemplo

En el ejemplo siguiente se muestra cómo funciona la conversión boxing implícita.

// vcmcppv2_explicit_boxing2.cpp
// compile with: /clr
using namespace System;

ref class A {
public:
   void func(System::Object^ o){Console::WriteLine("in A");}
};

value class V {};

interface struct IFace {
   void func();
};

value class V1 : public IFace {
public:
   virtual void func() {
      Console::WriteLine("Interface function");
   }
};

value struct V2 {
   // conversion operator to System::Object
   static operator System::Object^(V2 v2) {
      Console::WriteLine("operator System::Object^");
      return (V2^)v2;
   }
};

void func1(System::Object^){Console::WriteLine("in void func1(System::Object^)");}
void func1(V2^){Console::WriteLine("in func1(V2^)");}

void func2(System::ValueType^){Console::WriteLine("in func2(System::ValueType^)");}
void func2(System::Object^){Console::WriteLine("in func2(System::Object^)");}

int main() {
   // example 1 simple implicit boxing
   Int32^ bi = 1;
   Console::WriteLine(bi);

   // example 2 calling a member with implicit boxing
   Int32 n = 10;
   Console::WriteLine("xx = {0}", n.ToString());

   // example 3 implicit boxing for function calls
   A^ a = gcnew A;
   a->func(n);

   // example 4 implicit boxing for WriteLine function call
   V v;
   Console::WriteLine("Class {0} passed using implicit boxing", v);
   Console::WriteLine("Class {0} passed with forced boxing", (V^)(v));   // force boxing

   // example 5 casting to a base with implicit boxing
   V1 v1;
   IFace ^ iface = v1;
   iface->func();

   // example 6 user-defined conversion preferred over implicit boxing for function-call parameter matching
   V2 v2;
   func1(v2);   // user defined conversion from V2 to System::Object preferred over implicit boxing
                // Will call void func1(System::Object^);

   func2(v2);   // OK: Calls "static V2::operator System::Object^(V2 v2)"
   func2((V2^)v2);   // Using explicit boxing: calls func2(System::ValueType^)
}

Output

Vea también

Conceptos

Extensiones de componentes para plataformas de tiempo de ejecución