指定したオブジェクトに Normal ハンドルを割り当てます。
Overloads Public Shared Function Alloc( _
ByVal value As Object _) As GCHandle
[C#]
public static GCHandle Alloc(objectvalue);
[C++]
public: static GCHandle Alloc(Object* value);
[JScript]
public static function Alloc(
value : Object) : GCHandle;
パラメータ
- value
GCHandle を使用するオブジェクト。
戻り値
オブジェクトをガベージ コレクションから保護する新しい GCHandle 。 GCHandle は、不要になったときに Free で解放する必要があります。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentException | 非プリミティブ (非 blittable) メンバを持つインスタンスは固定できません。 |
解説
Normal ハンドルは非透過です。つまり、このハンドルによって、その中に格納されているオブジェクトのアドレスを解決することはできません。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
.NET Framework セキュリティ:
- SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
参照
GCHandle 構造体 | GCHandle メンバ | System.Runtime.InteropServices 名前空間 | GCHandle.Alloc オーバーロードの一覧 | GCHandleType