title	Platform::Box Class | Microsoft Docs
ms.custom
ms.date	12/30/2016
ms.technology	cpp-windows
ms.topic	reference
f1_keywords	VCCORLIB/Platform::Box
dev_langs	C++
ms.assetid	b3d7ea37-e98a-4fbc-80b0-ad35e50250c6
author	mikeblome
ms.author	mblome
ms.workload	cplusplus

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