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)

[SecurityCriticalAttribute]
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.

Exception Condition
ArgumentException

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

SecurityCriticalAttribute

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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: