GCHandle GCHandle GCHandle GCHandle Struct

Определение

Предоставляет способ доступа к управляемому объекту из неуправляемой памяти.Provides a way to access a managed object from unmanaged memory.

public value class GCHandle
[System.Runtime.InteropServices.ComVisible(true)]
public struct GCHandle
type GCHandle = struct
Public Structure GCHandle
Наследование
Атрибуты

Примеры

В следующем примере показан 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
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

Комментарии

GCHandle Структура будет использована в GCHandleType перечисления для создания дескриптора, соответствующего любого управляемого объекта.The GCHandle structure is used with the GCHandleType enumeration to create a handle corresponding to any managed object. Этот дескриптор может быть один из четырех типов: Weak, WeakTrackResurrection, Normal, или Pinned.This handle can be one of four types: Weak, WeakTrackResurrection, Normal, or Pinned. Если дескриптор выделен, его можно использовать для предотвращения собираются сборщиком мусора, когда неуправляемый клиент содержит только одну ссылку на управляемый объект.When the handle has been allocated, you can use it to prevent the managed object from being collected by the garbage collector when an unmanaged client holds the only reference. Без такого дескриптора объект может быть собран сборщиком мусора до завершения его работы от имени неуправляемого клиента.Without such a handle, the object can be collected by the garbage collector before completing its work on behalf of the unmanaged client.

Можно также использовать GCHandle для создания закрепленного объекта, который возвращает адрес памяти, чтобы помешать сборщику мусора перемещать объект в памяти.You can also use GCHandle to create a pinned object that returns a memory address to prevent the garbage collector from moving the object in memory.

Когда дескриптор выходит из области необходимо явно освободить его, вызвав Free метода; в противном случае — памяти, могут возникнуть утечки.When the handle goes out of scope you must explicitly release it by calling the Free method; otherwise, memory leaks may occur. При освобождении закрепленный дескриптор, связанный объект освобождается и становится доступным для сборки мусора, если нет других ссылок на него.When you free a pinned handle, the associated object will be unpinned and will become eligible for garbage collection, if there are no other references to it.

Свойства

IsAllocated IsAllocated IsAllocated IsAllocated

Возвращает значение, показывающее, выделен ли дескриптор.Gets a value indicating whether the handle is allocated.

Target Target Target Target

Возвращает или задает объект, предоставляемый дескриптором.Gets or sets the object this handle represents.

Методы

AddrOfPinnedObject() AddrOfPinnedObject() AddrOfPinnedObject() AddrOfPinnedObject()

Извлекает адрес объекта в Pinned обработки.Retrieves the address of an object in a Pinned handle.

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.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, является ли указанного GCHandle объект равен текущему GCHandle объекта.Determines whether the specified GCHandle object is equal to the current GCHandle object.

Free() Free() Free() Free()

Выпуски GCHandle.Releases a GCHandle.

FromIntPtr(IntPtr) FromIntPtr(IntPtr) FromIntPtr(IntPtr) FromIntPtr(IntPtr)

Возвращает новый GCHandle объект, созданный из дескриптора управляемого объекта.Returns a new GCHandle object created from a handle to a managed object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает идентификатор для текущего GCHandle объекта.Returns an identifier for the current GCHandle object.

ToIntPtr(GCHandle) ToIntPtr(GCHandle) ToIntPtr(GCHandle) ToIntPtr(GCHandle)

Возвращает внутреннее целочисленное представление GCHandle объекта.Returns the internal integer representation of a GCHandle object.

Операторы

Equality(GCHandle, GCHandle) Equality(GCHandle, GCHandle) Equality(GCHandle, GCHandle) Equality(GCHandle, GCHandle)

Возвращает значение, указывающее, является ли два GCHandle объекты равны.Returns a value indicating whether two GCHandle objects are equal.

Explicit(IntPtr to GCHandle) Explicit(IntPtr to GCHandle) Explicit(IntPtr to GCHandle) Explicit(IntPtr to GCHandle)

Дескриптор GCHandle хранится в виде целого числа как внутреннего представления.A GCHandle is stored using an internal integer representation.

Explicit(GCHandle to IntPtr) Explicit(GCHandle to IntPtr) Explicit(GCHandle to IntPtr) Explicit(GCHandle to IntPtr)

Дескриптор GCHandle хранится в виде целого числа как внутреннего представления.A GCHandle is stored using an internal integer representation.

Inequality(GCHandle, GCHandle) Inequality(GCHandle, GCHandle) Inequality(GCHandle, GCHandle) Inequality(GCHandle, GCHandle)

Возвращает значение, указывающее, является ли два GCHandle объекты не равны.Returns a value indicating whether two GCHandle objects are not equal.

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

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