Практическое руководство. Объявление дескрипторов в собственных типах

Нельзя объявить тип дескриптора в собственном типе. vcclr.h предоставляет шаблон gcroot защищенного типа оболочки для ссылки на объект CLR из кучи C++. Этот шаблон позволяет внедрить виртуальный дескриптор в собственный тип и рассматривать его как если бы он был базовым типом. В большинстве случаев объект можно использовать gcroot в качестве внедренного типа без приведения. Однако для каждого из них необходимо использовать static_cast для получения базовой управляемой ссылки.

Шаблон gcroot реализуется с помощью объектов класса value 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
}
hello

В этом примере показано, как создать 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 );
}
hello

В этом примере показано, как использовать 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);
}
String in V: Hello

См. также

Использование взаимодействия языка C++ (неявный PInvoke)