Compartilhar via


Conversão boxing (C++/CX)

Boxing é o processo de encapsular uma variável de tipo valor, como Windows::Foundation::DateTime—ou um tipo escalar fundamental, como int—dentro de uma classe referência quando a variável é passada para um método que usa Platform::Object^ como tipo de entrada.

Passando um tipo de valor a um parâmetro Object^

Embora você não precise fazer uma conversão explícita de uma variável para passá-la a um parâmetro de método do tipo Platform::Object^, você precisa converter explicitamente de volta para o tipo original ao recuperar valores que foram previamente encapsulados.

Object^ obj = 5; //scalar value is implicitly boxed
int i = safe_cast<int>(obj); //unboxed with explicit cast. 

Usando Platform::IBox<T> para oferecer suporte a tipos que permitem valor nulo

C# e Visual Basic oferecem suporte ao conceito de tipos de valor anuláveis. Em C++/CX, você pode usar o tipo Platform::IBox<T> para expor os métodos públicos que oferecem suporte a parâmetros de tipo de valor anulável. O exemplo a seguir mostra um método público C++/CX que retorna nulo quando um chamador do C# passa nulo para um dos argumentos.

// A WinRT Component DLL
namespace BoxingDemo
{
    public ref class Class1 sealed
    {
    public:
        Class1(){}
        Platform::IBox<int>^ Multiply(Platform::IBox<int>^ a, Platform::IBox<int>^ b)
        {
            if(a == nullptr || b == nullptr)
                return nullptr;
            else
                return ref new Platform::Box<int>(a->Value * b->Value);
        }
    };

Em um cliente XAML do C#, você pode consumi-lo deste modo:

// C# client code
BoxingDemo.Class1 obj = new BoxingDemo.Class1();
int? a = null;
int? b = 5;
var result = obj.Multiply(a, b); //result = null

Confira também

Sistema de tipos (C++/CX)
Conversão (C++/CX)
Referência da linguagem C++/CX
Referência de namespaces