方法: ネイティブ型のハンドルを宣言する

ネイティブ型でハンドル型を宣言することはできません。 vcclr.h には、C++ ヒープから CLR オブジェクトを参照するタイプ セーフ ラッパー テンプレート gcroot が備わっています。 このテンプレートを使用すると、ネイティブ型に仮想ハンドルを埋め込み、基になる型である場合と同様に扱います。 ほとんどの場合、gcroot オブジェクトをキャストせずに埋め込み型として使用できます。 ただし、それぞれで、static_cast を使用して、基なるマネージド参照を取得する必要があります。

この gcroot テンプレートは、ガベージ コレクション ヒープに "ハンドル" を提供する値クラス System::Runtime::InteropServices::GCHandle の 機能を使用して実装されます。 ハンドル自体は ガベージ コレクションされません。また、gcroot クラスのデストラクターによって使用されなくなった場合は解放されます (このデストラクターは手動で呼び出す必要はありません)。 ネイティブ ヒープで gcroot オブジェクトをインスタンス化する場合は、そのリソースで delete を呼び出す必要があります。

ランタイムは、ハンドルと、それが参照する CLR オブジェクトとの間の関連付けを維持します。 CLR オブジェクトがガベージ コレクション ヒープと一緒に移動すると、ハンドルはオブジェクトの新しいアドレスを返します。 gcroot テンプレートに割り当てる前に、変数をピン留めする必要はありません。

例

このサンプルでは、ネイティブ スタックに gcroot オブジェクトを作成する方法を示します。

// mcpp_gcroot.cpp
// compile with: /clr
#include <vcclr.h>
using namespace System;

class CppClass {
public:
   gcroot<String^> str;   // can use str as if it were String^
   CppClass() {}
};

int main() {
   CppClass c;
   c.str = gcnew String("hello");
   Console::WriteLine( c.str );   // no cast required
}

hello

このサンプルでは、ネイティブ ヒープに gcroot オブジェクトを作成する方法を示します。

// mcpp_gcroot_2.cpp
// compile with: /clr
// compile with: /clr
#include <vcclr.h>
using namespace System;

struct CppClass {
   gcroot<String ^> * str;
   CppClass() : str(new gcroot<String ^>) {}

   ~CppClass() { delete str; }

};

int main() {
   CppClass c;
   *c.str = gcnew String("hello");
   Console::WriteLine( *c.str );
}

hello

このサンプルでは、gcroot を使用して、ボックス型で gcroot を使用して、ネイティブ型の値型 (参照型ではない) への参照を保持する方法を示します。

// mcpp_gcroot_3.cpp
// compile with: /clr
#include < vcclr.h >
using namespace System;

public value struct V {
   String^ str;
};

class Native {
public:
   gcroot< V^ > v_handle;
};

int main() {
   Native native;
   V v;
   native.v_handle = v;
   native.v_handle->str = "Hello";
   Console::WriteLine("String in V: {0}", native.v_handle->str);
}

String in V: Hello

関連項目

C++ Interop (暗黙の PInvoke) の使用