Postupy: Deklarace obslužných rutin v nativních typech

Typ popisovače nelze deklarovat v nativním typu. vcclr.h poskytuje šablonu obálky gcroot bezpečného typu, která odkazuje na objekt CLR z haldy jazyka C++. Tato šablona umožňuje vložit virtuální popisovač do nativního typu a považovat ho za základní typ. Ve většině případů můžete objekt použít gcroot jako vložený typ bez jakéhokoli přetypování. U každého z nich však musíte použít static_cast k načtení podkladového spravovaného odkazu.

Šablona gcroot se implementuje pomocí zařízení třídy value System::Runtime::InteropServices::GCHandle, která poskytuje "popisovače" do haldy shromážděné v paměti. Všimněte si, že samotné popisovače nejsou uvolňování paměti a jsou uvolněny, pokud již nepoužívá destruktor ve gcroot třídě (tento destruktor nelze volat ručně). Pokud vytvoříte instanci objektu gcroot v nativní haldě, musíte volat odstranění daného prostředku.

Modul runtime zachová přidružení mezi popisovačem a objektem CLR, na který odkazuje. Když se clR objekt přesune s uvolňováním paměti haldy, popisovač vrátí novou adresu objektu. Proměnná se před přiřazením gcroot k šabloně nemusí připnout.

Příklady

Tato ukázka ukazuje, jak vytvořit gcroot objekt v nativním zásobníku.

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

Tato ukázka ukazuje, jak vytvořit gcroot objekt v nativní haldě.

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

V této ukázce se dozvíte, jak používat gcroot odkazy na typy hodnot (nikoli odkazy) v nativním typu pomocí gcroot v krabicovém typu.

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

Viz také

Použití zprostředkovatele komunikace C++ (implicitní služba PInvoke)