Platform::Box Class

Enables a value type such as Windows::Foundation::DateTime or a scalar type such as int to be stored in a Platform::Object type. It is usually not necessary to use Box explicitly because boxing happens implicitly when you cast a value type to Object^.

Syntax

ref class Box abstract;

Requirements

Header: vccorlib.h

Namespace: Platform

Members

Member	Description
Box	Creates a Box that can encapsulate a value of the specified type.
operator Box<const T>^	Enables boxing conversions from a const value class T or enum class T to Box<T>.
operator Box<const volatile T>^	Enables boxing conversions from a const volatile value class T or enum type T to Box<T>.
operator Box<T>^	Enables boxing conversions from a value class T to Box<T>.
operator Box<volatile T>^	Enables boxing conversions from a volatile value class T or enum type T to Box<T>.
Box::operator T	Enables boxing conversions from a value class T or enum class T to Box<T>.
Value property	Returns the value that is encapsulated in the Box object.

Box::Box Constructor

Creates a Box that can encapsulate a value of the specified type.

Syntax

Box(T valueArg);

Parameters

valueArg
The type of value to be boxed—for example, int, bool, float64, DateTime.

Box::operator Box<const T>^ Operator

Enables boxing conversions from a const value class T or enum class T to Box<T>.

Syntax

operator Box<const T>^(const T valueType);

Parameters

T
Any value class, value struct, or enum type. Includes the built-in types in the default namespace.

Return Value

A Platform::Box<T>^ instance that represents the original value boxed in a ref class.

Box::operator Box<const volatile T>^ Operator

Enables boxing conversions from a const volatile value class T or enum type T to Box<T>.

Syntax

operator Box<const volatile T>^(const volatile T valueType);

Parameters

T
Any enum type, value class, or value struct. Includes the built-in types in the default namespace.

Return Value

A Platform::Box<T>^ instance that represents the original value boxed in a ref class.

Box::operator Box<T>^ Operator

Enables boxing conversions from a value class T to Box<T>.

Syntax

operator Box<const T>^(const T valueType);

Parameters

T
Any enum type, value class, or value struct. Includes the built-in types in the default namespace.

Return Value

A Platform::Box<T>^ instance that represents the original value boxed in a ref class.

Box::operator Box<volatile T>^ Operator

Enables boxing conversions from a volatile value class T or enum type T to Box<T>.

Syntax

operator Box<volatile T>^(volatile T valueType);

Parameters

T
Any enum type, value class, or value struct. Includes the built-in types in the default namespace.

Return Value

A Platform::Box<T>^ instance that represents the original value boxed in a ref class.

Box::operator T Operator

Enables boxing conversions from a value class T or enum class T to Box<T>.

Syntax

operator Box<T>^(T valueType);

Parameters

T
Any enum type, value class, or value struct. Includes the built-in types in the default namespace.

Return Value

A Platform::Box<T>^ instance that represents the original value boxed in a ref class.

Box::Value Property

Returns the value that is encapsulated in the Box object.

Syntax

virtual property T Value{
   T get();
}

Return Value

Returns the boxed value with the same type as it originally had before it was boxed.

See also

Platform namespace
Boxing