Article
11/18/2011

GCHandle.Alloc Method (Object, GCHandleType)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

This member can be used only by trusted applications. If you try to use this member in a partial-trust application, your code will throw a MethodAccessException exception. This member is security-critical, which restricts its use.

[SECURITY CRITICAL]

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

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

Syntax

'Declaration
<SecurityCriticalAttribute> _
Public Shared Function Alloc ( _
    value As Object, _
    type As GCHandleType _
) As GCHandle

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Share via