Sdílet prostřednictvím


GCHandle.Alloc Metoda

Definice

Přidělí popisovač pro zadaný objekt.

Přetížení

Alloc(Object)

Normal Přidělí popisovač pro zadaný objekt.

Alloc(Object, GCHandleType)

Přidělí popisovač zadaného typu pro zadaný objekt.

Alloc(Object)

Zdroj:
GCHandle.cs
Zdroj:
GCHandle.cs
Zdroj:
GCHandle.cs

Normal Přidělí popisovač pro zadaný objekt.

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

Parametry

value
Object

Objekt, který používá GCHandle.

Návraty

Nový GCHandle , který chrání objekt před uvolňováním paměti. Tato GCHandle položka musí být uvolněna se sadou Free() , pokud už není potřeba.

Atributy

Příklady

Následující příklad ukazuje App třídu, která vytvoří popisovač spravovaného objektu GCHandle.Alloc pomocí metody , která brání shromažďování spravovaného objektu. Volání EnumWindows metody předá delegáta a spravovaný objekt (oba jsou deklarovány jako spravované typy, ale nejsou zobrazeny) a přetypuje popisovač na IntPtr. Nespravovaná funkce předá typ zpět volajícímu jako parametr funkce zpětného volání.

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

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();
    }

    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

Poznámky

Normal popisovače jsou neprůžné, což znamená, že prostřednictvím popisovače nelze přeložit adresu objektu, který obsahuje.

Viz také

Platí pro

Alloc(Object, GCHandleType)

Zdroj:
GCHandle.cs
Zdroj:
GCHandle.cs
Zdroj:
GCHandle.cs

Přidělí popisovač zadaného typu pro zadaný objekt.

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);
public static System.Runtime.InteropServices.GCHandle Alloc (object? value, System.Runtime.InteropServices.GCHandleType type);
public static System.Runtime.InteropServices.GCHandle Alloc (object value, System.Runtime.InteropServices.GCHandleType type);
[<System.Security.SecurityCritical>]
static member Alloc : obj * System.Runtime.InteropServices.GCHandleType -> System.Runtime.InteropServices.GCHandle
static member Alloc : obj * System.Runtime.InteropServices.GCHandleType -> System.Runtime.InteropServices.GCHandle
Public Shared Function Alloc (value As Object, type As GCHandleType) As GCHandle

Parametry

value
Object

Objekt, který používá GCHandle.

type
GCHandleType

Jedna z GCHandleType hodnot označující typ, který GCHandle se má vytvořit.

Návraty

Novinka GCHandle zadaného typu. Tato GCHandle položka musí být uvolněna se sadou Free() , pokud už není potřeba.

Atributy

Výjimky

Instanci s neprimitivními (nebližitelnými) členy nelze připnout.

Viz také

Platí pro