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;  

Remarks

Requirements

Header: vccorlib.h

Namespace: Platform

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>.

Box::Box Constructor

Creates a Box that can encapsulate a value of the specified type.| |Value property|Returns the value that is encapsulated in the Box object.|

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