Jak: zadeklarować uchwytów macierzystych typów
Nie można zadeklarować typu uchwyt macierzysty typu.vcclr.h zawiera szablon otoka typu bezpiecznej gcroot do odwoływania się do obiektu CLR ze stosu C++.Ten szablon umożliwia osadzanie wirtualnego uchwyt w typu macierzystego i należy traktować jak gdyby podstawowy typ.W większości przypadków można użyć gcroot obiekt osadzony typ bez żadnych rzutowania.Jednakże, z dla każdego z nich w, należy użyć static_cast pobrać podstawowej odniesienia zarządzanych.
gcroot Szablonu jest zaimplementowana przy użyciu obiektów klasy wartość System::Runtime::InteropServices::GCHandle, który zapewnia "uchwyty" do zebranych garbage sterty.Należy zauważyć, że same uchwyty nie są czyszczenie i są zwalniane nie jest już w użyciu przez destruktor w gcroot klasy (destruktora tej nie można ręcznie wywołać).Jeśli można utworzyć wystąpienia gcroot obiektów na stercie macierzysty musi wywołać usunąć z tego zasobu.
Środowisko wykonawcze będzie utrzymywać skojarzenia pomiędzy uchwyt obiektu CLR, którego się odwołuje.Gdy obiekt CLR przesuwa się z zebranych garbage sterty, uchwyt zwróci adres nowego obiektu.Zmienna nie podpięty, zanim zostanie on przypisany do gcroot szablonu.
Przykład
W przykładzie pokazano, jak utworzyć gcroot obiektów na stosie macierzystym.
// 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
}
W przykładzie pokazano, jak utworzyć gcroot obiektów na stercie macierzystym.
// 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 );
}
W przykładzie przedstawiono sposób użycia gcroot do przechowywania odwołań do typów wartości (nie typy odwołań) w macierzystym typu za pomocą gcroot na ramkach 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);
}