GCHandle.Alloc GCHandle.Alloc GCHandle.Alloc GCHandle.Alloc Method

Определение

Выделяет дескриптор для указанного объекта.Allocates a handle for the specified object.

Перегрузки

Alloc(Object) Alloc(Object) Alloc(Object) Alloc(Object)

Выделяет дескриптор Normal для указанного объекта.Allocates a Normal handle for the specified object.

Alloc(Object, GCHandleType) Alloc(Object, GCHandleType) Alloc(Object, GCHandleType) Alloc(Object, GCHandleType)

Выделяет дескриптор указанного типа для указанного объекта.Allocates a handle of the specified type for the specified object.

Alloc(Object) Alloc(Object) Alloc(Object) Alloc(Object)

Выделяет дескриптор Normal для указанного объекта.Allocates a Normal handle for the specified object.

public:
 static System::Runtime::InteropServices::GCHandle Alloc(System::Object ^ value);
[System.Security.SecurityCritical]
public static System.Runtime.InteropServices.GCHandle Alloc (object value);
static member Alloc : obj -> System.Runtime.InteropServices.GCHandle
Public Shared Function Alloc (value As Object) As GCHandle

Параметры

value
Object Object Object Object

Объект, использующий дескриптор GCHandle.The object that uses the GCHandle.

Возвраты

Новый дескриптор GCHandle, защищающий объект от сборщика мусора.A new GCHandle that protects the object from garbage collection. Этот дескриптор GCHandle должен освобождаться с помощью метода Free(), если в нем больше нет необходимости.This GCHandle must be released with Free() when it is no longer needed.

Примеры

В следующем примере показан App класс, который создает обработчик для управляемого объекта GCHandle.Alloc с помощью метода, который предотвращает сбор управляемого объекта.The following example shows an App class that creates a handle to a managed object using the GCHandle.Alloc method, which prevents the managed object from being collected. Вызов EnumWindows метода передает делегат и управляемый объект (оба объявляются как управляемые типы, но не отображаются) и приводит этот обработчик IntPtrк типу.A call to the EnumWindows method passes a delegate and a managed object (both declared as managed types, but not shown), and casts the handle to an IntPtr. Неуправляемая функция передает тип обратно вызывающему объекту в качестве параметра функции обратного вызова.The unmanaged function passes the type back to the caller as a parameter of the callback function.

using System;
using System.IO;
using System.Threading;
using System.Windows.Forms;
using System.Runtime.InteropServices;
using System.Security.Permissions;

public delegate bool CallBack(int handle, IntPtr param);

public class LibWrap
{
	// passing managed object as LPARAM
	// BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam);

	[DllImport("user32.dll")]
	public static extern bool EnumWindows(CallBack cb, IntPtr param);
}

public class App
{
	public static void Main()
	{
		Run();
	}

        [SecurityPermission(SecurityAction.Demand, UnmanagedCode=true)]
	public static void Run()
        {
		TextWriter tw = System.Console.Out;
		GCHandle gch = GCHandle.Alloc(tw);

		CallBack cewp = new CallBack(CaptureEnumWindowsProc);

		// platform invoke will prevent delegate to be garbage collected
		// before call ends

		LibWrap.EnumWindows(cewp, GCHandle.ToIntPtr(gch));
		gch.Free();
        }

	private static bool CaptureEnumWindowsProc(int handle, IntPtr param)
	{
		GCHandle gch = GCHandle.FromIntPtr(param);
		TextWriter tw = (TextWriter)gch.Target;
		tw.WriteLine(handle);
		return true;
	}
}
Imports System.IO
Imports System.Threading
Imports System.Windows.Forms
Imports System.Runtime.InteropServices
Imports System.Security.Permissions

Public Delegate Function CallBack(ByVal handle As Integer, ByVal param As IntPtr) As Boolean


Module LibWrap

    ' passing managed object as LPARAM
    ' BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam);
    <DllImport("user32.dll")> _
    Function EnumWindows(ByVal cb As CallBack, ByVal param As IntPtr) As Boolean
    End Function
End Module 'LibWrap


Module App

    Sub Main()
	Run()

    End Sub

    <SecurityPermission(SecurityAction.Demand, UnmanagedCode:=true)> _
    Sub Run()

        Dim tw As TextWriter = System.Console.Out
        Dim gch As GCHandle = GCHandle.Alloc(tw)

        Dim cewp As CallBack
        cewp = AddressOf CaptureEnumWindowsProc

        ' platform invoke will prevent delegate to be garbage collected
        ' before call ends
        LibWrap.EnumWindows(cewp, GCHandle.ToIntPtr(gch))
        gch.Free()

    End Sub


    Function CaptureEnumWindowsProc(ByVal handle As Integer, ByVal param As IntPtr) As Boolean
        Dim gch As GCHandle = GCHandle.FromIntPtr(param)
        Dim tw As TextWriter = CType(gch.Target, TextWriter)
        tw.WriteLine(handle)
        Return True

    End Function
End Module

Комментарии

NormalДескрипторы являются непрозрачными. Это означает, что нельзя разрешить адрес объекта, который он содержит, через дескриптор.Normal handles are opaque, which means that you cannot resolve the address of the object it contains through the handle.

Безопасность

SecurityCriticalAttribute
требуется полное доверие для немедленного вызывающего объекта.requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

Дополнительно

Alloc(Object, GCHandleType) Alloc(Object, GCHandleType) Alloc(Object, GCHandleType) Alloc(Object, GCHandleType)

Выделяет дескриптор указанного типа для указанного объекта.Allocates a handle of the specified type for the specified object.

public:
 static System::Runtime::InteropServices::GCHandle Alloc(System::Object ^ value, System::Runtime::InteropServices::GCHandleType type);
[System.Security.SecurityCritical]
public static System.Runtime.InteropServices.GCHandle Alloc (object value, System.Runtime.InteropServices.GCHandleType type);
static member Alloc : obj * System.Runtime.InteropServices.GCHandleType -> System.Runtime.InteropServices.GCHandle
Public Shared Function Alloc (value As Object, type As GCHandleType) As GCHandle

Параметры

value
Object Object Object Object

Объект, использующий дескриптор GCHandle.The object that uses the GCHandle.

type
GCHandleType GCHandleType GCHandleType GCHandleType

Одно из значений GCHandleType, показывающее тип создаваемого дескриптора GCHandle.One of the GCHandleType values, indicating the type of GCHandle to create.

Возвраты

Новый дескриптор GCHandle указанного типа.A new GCHandle of the specified type. Этот дескриптор GCHandle должен освобождаться с помощью метода Free(), если в нем больше нет необходимости.This GCHandle must be released with Free() when it is no longer needed.

Исключения

Экземпляр с членами, не являющимися примитивами (не требующими преобразования), не может быть закреплен.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.

Дополнительно

Применяется к