방법: 네이티브 형식으로 핸들 선언

네이티브 형식에서는 핸들 형식을 선언할 수 없습니다. vcclr.h는 C++ 힙에서 CLR 개체를 참조하는 형식 안전 래퍼 템플릿 gcroot 을 제공합니다. 이 템플릿을 사용하면 네이티브 형식에 가상 핸들을 포함하고 기본 형식인 것처럼 처리할 수 있습니다. 대부분의 경우 캐스팅 없이 개체를 gcroot 포함된 형식으로 사용할 수 있습니다. 그러나 각각에 대해 기본 관리되는 참조를 검색하는 데 사용해야 static_cast 합니다.

템플릿은 gcroot 가비지 수집 힙에 "핸들"을 제공하는 Value 클래스 System::Runtime::InteropServices::GCHandle의 기능을 사용하여 구현됩니다. 핸들 자체는 가비지 수집되지 않으며 클래스의 소멸자가 gcroot 더 이상 사용하지 않을 때 해제됩니다(이 소멸자는 수동으로 호출할 수 없음). 네이티브 힙에서 개체를 gcroot 인스턴스화하는 경우 해당 리소스에서 delete를 호출해야 합니다.

런타임은 참조하는 핸들과 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

이 샘플에서는 boxed 형식을 사용하여 gcrootgcroot 네이티브 형식의 값 형식(참조 형식 아님)에 대한 참조를 유지하는 방법을 보여 줍니다.

// 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++ Interop 사용(암시적 PInvoke)