Практическое руководство. Объявление дескрипторов в собственных типах
Тип дескриптора невозможно объявить в собственном типе. В файле vcclr.h представлен типобезопасный шаблон оболочки gcroot для ссылки на объект CLR из кучи C++. Этот шаблон позволяет встраивать виртуальный дескриптор в собственный тип и обрабатывать его, как любой базовый тип. В большинстве случаев объект gcroot можно использовать в качестве встроенного типа без приведения типов. Однако при наличии for each, in необходимо использовать static_cast для извлечения базовой управляемой ссылки.
Шаблон gcroot реализован с помощью средств класса System::Runtime::InteropServices::GCHandle, который предоставляет "дескрипторы" в куче со сбором мусора. Обратите внимание, что сами дескрипторы не собираются и удаляются, когда они больше не используются, деструктором класса gcroot (вручную вызвать его нельзя). При создании экземпляра объекта gcroot в собственной куче необходимо вызвать удаление в этом ресурсе.
Среда выполнения поддерживает связь между дескриптором и объектом 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
}
В этом примере показано, как создать объект 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 );
}
В этом примере показано, как применить gcroot для сохранения ссылок на типы значения (не ссылочные типы) в собственном типе, используя объект 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);
}