如何：以原生類型宣告控制代碼

您無法在原生類型中宣告控制碼類型。 vcclr.h 提供型別安全包裝函式範本 gcroot ，以參考 C++ 堆積中的 CLR 物件。 此範本可讓您在原生類型中內嵌虛擬控制碼，並將其視為基礎類型。 在大部分情況下，您可以使用 gcroot 物件做為內嵌類型，而不需要任何轉換。 不過，針對 中的每個 ，您必須使用 static_cast 來擷取基礎 Managed 參考。

此 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 在 Boxed 型別上使用，在原生型 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)