Procedura: dichiarare handle in tipi nativi

Non è possibile dichiarare un tipo handle in un tipo nativo. vcclr.h fornisce il modello gcroot wrapper indipendente dai tipi per fare riferimento a un oggetto CLR dall'heap C++. Questo modello consente di incorporare un handle virtuale in un tipo nativo e considerarlo come se fosse il tipo sottostante. Nella maggior parte dei casi, è possibile usare l'oggetto gcroot come tipo incorporato senza cast. Tuttavia, con for each, è necessario usare static_cast per recuperare il riferimento gestito sottostante.

Il gcroot modello viene implementato usando le funzionalità della classe valore System::Runtime::InteropServices::GCHandle, che fornisce "handle" nell'heap sottoposto a Garbage Collection. Si noti che gli handle stessi non vengono raccolti dal Garbage Collection e vengono liberati quando non vengono più usati dal distruttore nella gcroot classe (questo distruttore non può essere chiamato manualmente). Se si crea un'istanza di un gcroot oggetto nell'heap nativo, è necessario chiamare delete per tale risorsa.

Il runtime manterrà un'associazione tra l'handle e l'oggetto CLR, a cui fa riferimento. Quando l'oggetto CLR viene spostato con l'heap sottoposto a Garbage Collection, l'handle restituirà il nuovo indirizzo dell'oggetto. Non è necessario aggiungere una variabile prima che venga assegnata a un gcroot modello.

Esempi

Questo esempio illustra come creare un gcroot oggetto nello stack nativo.

// 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

Questo esempio illustra come creare un gcroot oggetto nell'heap nativo.

// 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

In questo esempio viene illustrato come usare gcroot per contenere riferimenti a tipi valore (non tipi riferimento) in un tipo nativo usando gcroot sul tipo boxed.

// 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

Vedi anche

Uso delle funzionalità di interoperabilità C++ (PInvoke implicito)