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.

戻り値

オブジェクトをガベージ コレクションから保護する新しい GCHandleA 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);

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

注釈

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 値の 1 つ。One of the GCHandleType values, indicating the type of GCHandle to create.

戻り値

指定した型の新しい GCHandleA new GCHandle of the specified type. GCHandle は、不要になったときに Free() で解放する必要があります。This GCHandle must be released with Free() when it is no longer needed.

例外

非プリミティブ (blittable でない) メンバーを持つインスタンスは固定できません。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.

こちらもご覧ください

適用対象