Export (0) Print
Expand All

GCHandle.Alloc Method (Object, GCHandleType)

Allocates a handle of the specified type for the specified object.

Namespace:  System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

public static GCHandle Alloc(
	Object value,
	GCHandleType type
)

Parameters

value
Type: System.Object

The object that uses the GCHandle.

type
Type: System.Runtime.InteropServices.GCHandleType

One of the GCHandleType values, indicating the type of GCHandle to create.

Return Value

Type: System.Runtime.InteropServices.GCHandle
A new GCHandle of the specified type. This GCHandle must be released with Free when it is no longer needed.

ExceptionCondition
ArgumentException

An instance with nonprimitive (non-blittable) members cannot be pinned.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

  • SecurityCriticalAttribute 

    requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Show:
© 2015 Microsoft