Share via


GCHandle.Alloc Method (Object)

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 Normal handle for the specified object.

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

Syntax

'Declaration
<SecurityCriticalAttribute> _
Public Shared Function Alloc ( _
    value As Object _
) As GCHandle
[SecurityCriticalAttribute]
public static GCHandle Alloc(
    Object value
)

Parameters

Return Value

Type: System.Runtime.InteropServices.GCHandle
A new GCHandle that protects the object from garbage collection. 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.