GCHandle GCHandle GCHandle GCHandle Struct

Définition

Fournit un moyen d'accéder à un objet managé à partir d'une mémoire non managée.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
Héritage
Attributs

Exemples

L’exemple suivant montre un App classe qui crée un handle vers un objet managé à l’aide de la GCHandle.Alloc (méthode), ce qui empêche l’objet managé d’être collecté.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. Un appel à la EnumWindows méthode passe un délégué et un objet managé (à la fois déclaré en tant que types managés, mais non affichés) et le caste le handle vers un 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. La fonction non managée transmet le type à l’appelant en tant que paramètre de la fonction de rappel.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

Remarques

Le GCHandle structure est utilisée avec la GCHandleType énumération pour créer un handle correspondant à n’importe quel objet géré.The GCHandle structure is used with the GCHandleType enumeration to create a handle corresponding to any managed object. Ce handle peut être un des quatre types : Weak, WeakTrackResurrection, Normal, ou Pinned.This handle can be one of four types: Weak, WeakTrackResurrection, Normal, or Pinned. Lorsque le handle a été alloué, vous pouvez l’utiliser pour empêcher l’objet managé d’être collecté par le garbage collector lorsqu’un client non managé détient la seule référence.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. Sans un descripteur de ce type, l’objet peut être collecté par le garbage collector avant la fin de son travail au nom du client non managé.Without such a handle, the object can be collected by the garbage collector before completing its work on behalf of the unmanaged client.

Vous pouvez également utiliser GCHandle pour créer un objet épinglé qui retourne une adresse mémoire pour empêcher le garbage collector de déplacer l’objet en mémoire.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.

Lorsque le handle est hors de portée, vous devez le libérer explicitement en appelant le Free méthode ; sinon, mémoire fuites peuvent se produire.When the handle goes out of scope you must explicitly release it by calling the Free method; otherwise, memory leaks may occur. Lorsque vous libérez un handle épinglé, l’objet associé est libéré et deviendront éligible pour le garbage collection, s’il n’existe aucune autre référence à celui-ci.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.

Propriétés

IsAllocated IsAllocated IsAllocated IsAllocated

Obtient une valeur indiquant si le handle est alloué.Gets a value indicating whether the handle is allocated.

Target Target Target Target

Obtient ou définit l'objet représenté par le handle.Gets or sets the object this handle represents.

Méthodes

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

Récupère l’adresse d’un objet dans un Pinned gérer.Retrieves the address of an object in a Pinned handle.

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

Alloue un Normal gérer pour l’objet spécifié.Allocates a Normal handle for the specified object.

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

Alloue un handle du type spécifié pour l'objet spécifié.Allocates a handle of the specified type for the specified object.

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

Détermine si le texte spécifié GCHandle objet est égal à actuel GCHandle objet.Determines whether the specified GCHandle object is equal to the current GCHandle object.

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

Versions un GCHandle.Releases a GCHandle.

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

Retourne un nouvel GCHandle objet créé à partir d’un handle vers un objet managé.Returns a new GCHandle object created from a handle to a managed object.

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

Retourne un identificateur pour le cours GCHandle objet.Returns an identifier for the current GCHandle object.

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

Retourne la représentation d’entier interne d’un GCHandle objet.Returns the internal integer representation of a GCHandle object.

Opérateurs

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

Retourne une valeur indiquant si deux GCHandle objets sont égaux.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)

Un GCHandle est stockée en utilisant une représentation sous forme d’entier interne.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)

Un GCHandle est stockée en utilisant une représentation sous forme d’entier interne.A GCHandle is stored using an internal integer representation.

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

Retourne une valeur indiquant si deux GCHandle objets ne sont pas égaux.Returns a value indicating whether two GCHandle objects are not equal.

S’applique à

Voir aussi