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

Nelze deklarovat typ popisovače v nativním typu. Vcclr.h poskytuje šablonu obálky zajišťující bezpečnost typů gcroot Chcete-li odkazovat na CLR objekt z haldy jazyka C++.Tato šablona Vám umožňuje vložit virtuální popisovač v nativním typu a zacházet s ním jako by to byl podkladový typ.Ve většině případů můžete použít objekt gcroot jako vložený typ bez jakéhokoliv přetypování.Nicméně s pro každý v, musíte použít static_cast k načtení podkladového spravovaného odkazu.

Šablona gcroot je implementována použitím zařízení hodnoty třídy System::Runtime::InteropServices::GCHandle, který poskytuje "popisovače" do haldy uvolněné paměti. Všimněte si, že popisovače samy o sobě nejsou uvolněné z paměti a jsou uvolněny, když již nejsou k dispozici v použití destruktoru ve třídě gcroot (tento destruktor nelze volat ručně). Jestliže konkretizujete objekt gcroot na nativní haldu, musíte zavolat odstranění na tento prostředek.

Runtime bude udržovat přidružení mezi popisovačem a CLR objektem, který odkazuje.Když CLR objekt pohybuje s haldou uvolněné paměti, popisovač vrátí novou adresu objektu.Proměnná nemusí být připojena před přiřazením šablony gcroot.

Příklad

Tato ukázka znázorňuje, jak vytvořit objekt gcroot na 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
}

Tato ukázka znázorňuje, jak vytvořit objekt gcroot na 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 );
}

Tato ukázka znázorňuje jak použit gcroot k udržení odkazů na typy hodnot (nikoli typy odkazů) v nativním typu, použitím gcroot na zabalený typ.

// 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);
}

Viz také

Referenční dokumentace

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