GCHandle.Alloc Methode

Definition

Reserviert ein Handle für das angegebene Objekt.Allocates a handle for the specified object.

Überlädt

Alloc(Object)

Reserviert ein Normal-Handle für das angegebene Objekt.Allocates a Normal handle for the specified object.

Alloc(Object, GCHandleType)

Reserviert ein Handle vom angegebenen Typ für das angegebene Objekt.Allocates a handle of the specified type for the specified object.

Alloc(Object)

Reserviert ein Normal-Handle für das angegebene Objekt.Allocates a Normal handle for the specified object.

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

Parameter

value
Object

Das Objekt, das das GCHandle verwendet.The object that uses the GCHandle.

Gibt zurück

GCHandle

Ein neues GCHandle, das das Objekt vor der Garbage Collection schützt.A new GCHandle that protects the object from garbage collection. Dieses GCHandle muss mit Free() freigegeben werden, wenn es nicht mehr benötigt wird.This GCHandle must be released with Free() when it is no longer needed.

Attribute

Beispiele

Das folgende Beispiel zeigt eine- App Klasse, die mithilfe der-Methode ein Handle für ein verwaltetes Objekt erstellt GCHandle.Alloc , das verhindert, dass das verwaltete Objekt erfasst wird.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. Ein Aufruf der EnumWindows -Methode übergibt einen Delegaten und ein verwaltetes Objekt (beide als verwaltete Typen deklariert, jedoch nicht angezeigt) und wandelt das Handle in einen um 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. Die nicht verwaltete Funktion übergibt den Typ als Parameter der Rückruffunktion an den Aufrufer zurück.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);

internal static class NativeMethods
{
    // passing managed object as LPARAM
    // BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam);

    [DllImport("user32.dll")]
    internal 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 = Console.Out;
        GCHandle gch = GCHandle.Alloc(tw);

        CallBack cewp = new CallBack(CaptureEnumWindowsProc);

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

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


Friend Module NativeMethods

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


Module App

    Sub Main()

        Run()

    End Sub

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

        Dim tw As TextWriter = 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
        NativeMethods.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

Hinweise

Normal Handles sind nicht transparent, was bedeutet, dass Sie die Adresse des Objekts, das es enthält, nicht mit dem Handle auflösen können.Normal handles are opaque, which means that you cannot resolve the address of the object it contains through the handle.

Weitere Informationen

Gilt für:

Produkt Introduced

Alloc(Object, GCHandleType)

Reserviert ein Handle vom angegebenen Typ für das angegebene Objekt.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);
public static System.Runtime.InteropServices.GCHandle Alloc (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
[<System.Security.SecurityCritical>]
static member Alloc : obj * System.Runtime.InteropServices.GCHandleType -> System.Runtime.InteropServices.GCHandle
Public Shared Function Alloc (value As Object, type As GCHandleType) As GCHandle

Parameter

value
Object

Das Objekt, das das GCHandle verwendet.The object that uses the GCHandle.

type
GCHandleType

Einer der GCHandleType-Werte, der den Typ des zu erstellenden GCHandle angibt.One of the GCHandleType values, indicating the type of GCHandle to create.

Gibt zurück

GCHandle

Ein neues GCHandle vom angegebenen Typ.A new GCHandle of the specified type. Dieses GCHandle muss mit Free() freigegeben werden, wenn es nicht mehr benötigt wird.This GCHandle must be released with Free() when it is no longer needed.

Attribute

Ausnahmen

Eine Instanz mit nicht primitiven (nicht blitfähigen) Membern kann nicht fixiert werden.An instance with nonprimitive (non-blittable) members cannot be pinned.

Weitere Informationen

Gilt für:

Produkt Introduced