比如说,现在有一个用C#编写的DLL工程CsharpDll里面有一个Person类:
- //Person.cs
- usingSystem;
- namespaceCsharpDll
- {
- publicclassPerson
- {
- publicPerson()
- {
- Name="NoName";
- Sex='N';
- Age=0;
- m_strLastError="NoError";
- }
- publicPerson(stringstrName,charcSex,intiAge)
- {
- m_strLastError="NoError";
- Name=strName;
- Sex=cSex;
- Age=iAge;
- }
- publicstringName
- {
- get
- {
- returnm_strName;
- }
- set
- {
- if((String.IsNullOrEmpty(value))||(value.Length>127))
- {
- m_strName="NoName";
- m_strLastError="Thelengthoftheinputnameisoutofrange.";
- return;
- }
- m_strName=value;
- }
- }
- publiccharSex
- {
- get
- {
- returnm_cSex;
- }
- set
- {
- if((value!='F')&&(value!='M')&&(value!='m')&&(value!='f'))
- {
- m_cSex='N';
- m_strLastError="Theinputsexisoutof[F/M].";
- return;
- }
- m_cSex=value;
- }
- }
- publicintAge
- {
- get
- {
- returnm_iAge;
- }
- set
- {
- if((value<0)||(value>150))
- {
- m_iAge=0;
- m_strLastError="Theinputageisoutofrange.";
- return;
- }
- m_iAge=value;
- }
- }
- publicstringLastError
- {
- get
- {
- returnm_strLastError;
- }
- }
- privatestringm_strName;
- privatecharm_cSex;
- privateintm_iAge;
- privatestringm_strLastError;
- }
- }
如果需要在C++中使用这个C#编写的Person类,就需要用托管C++来对这个C#进行包装,将它包装成一个C++能用的类。
首先,要创建一个托管C++的DLL工程ManageCppDll。并且,要添加对CsharpDll.dll的引用。然后对C#类所有的公有属性和方法进行包装。下面是具体的代码:
- //ManageCppDll.h
- #pragmaonce
- #ifndefLX_DLL_CLASS_EXPORTS
- #defineLX_DLL_CLASS__declspec(dllexport)
- #else
- #defineLX_DLL_CLASS__declspec(dllimport)
- #endif
- classLX_DLL_CLASSCPerson
- {
- public:
- CPerson();
- CPerson(constwchar_t*pName,constwchar_tcSex,intiAge);
- ~CPerson();
- voidSetName(constwchar_t*pName);
- wchar_t*GetName();
- voidSetSex(constwchar_tcSex);
- wchar_tGetSex();
- voidSetAge(intiAge);
- intGetAge();
- wchar_t*GetLastError();
- private:
- //用一个void指针指向Person的对象
- //所有公有成员函数的实现都是通过这个对象来实现
- void*m_pImp;
- wchar_tm_szName[128];
- wchar_tm_szLastError[128];
- };
- //ManageCppDll.cpp
- #include"stdafx.h"
- #include"ManageCppDll.h"
- #include<vcclr.h>
- #include<string.h>
- #include<stdlib.h>
- usingnamespaceSystem;
- usingnamespaceSystem::Runtime::InteropServices;
- usingnamespaceCsharpDll;
- //将GCHandle转换成为void指针
- #define__GCHANDLE_TO_VOIDPTR(x)((GCHandle::operatorSystem::IntPtr(x)).ToPointer())
- //将void指针转换为GCHandle
- #define__VOIDPTR_TO_GCHANDLE(x)(GCHandle::operatorGCHandle(System::IntPtr(x)))
- //辅助函数
- //将void指针指向的对象转换成为Person对象
- inlinePerson^GetImpObj(void*pHandle)
- {
- Person^person=nullptr;
- if(pHandle!=NULL)
- {
- person=static_cast<Person^>(__VOIDPTR_TO_GCHANDLE(pHandle).Target);
- }
- returnperson;
- }
- CPerson::CPerson()
- {
- m_pImp=NULL;
- Person^person=gcnewPerson();
- //创建GCHandle并将它转换成void指针保存到成员变量中
- GCHandlehandle=GCHandle::Alloc(person);
- m_pImp=__GCHANDLE_TO_VOIDPTR(handle);
- }
- CPerson::CPerson(constwchar_t*pName,constwchar_tcSex,intiAge)
- {
- m_pImp=NULL;
- Person^person=gcnewPerson();
- person->Name=gcnewString(pName);
- person->Sex=cSex;
- person->Age=iAge;
- GCHandlehandle=GCHandle::Alloc(person);
- m_pImp=__GCHANDLE_TO_VOIDPTR(handle);
- }
- CPerson::~CPerson()
- {
- if(m_pImp==NULL)
- return;
- //释放GCHandle
- GCHandlehandle=__VOIDPTR_TO_GCHANDLE(m_pImp);
- handle.Free();
- m_pImp=NULL;
- }
- voidCPerson::SetName(constwchar_t*pName)
- {
- //将void指针转换成Person指针
- //并用该指针调用相应的公有属性或方法
- Person^person=GetImpObj(m_pImp);
- person->Name=gcnewString(pName);
- }
- wchar_t*CPerson::GetName()
- {
- Person^person=GetImpObj(m_pImp);
- //将C#返回的字符串转换为wchat_t*指针能指向的地址
- wchar_t*pName=static_cast<wchar_t*>(Marshal::StringToHGlobalUni(person->Name).ToPointer());
- wcscpy_s(m_szName,pName);
- Marshal::FreeHGlobal(System::IntPtr(pName));//释放内存
- returnm_szName;
- }
- voidCPerson::SetSex(constwchar_tcSex)
- {
- Person^person=GetImpObj(m_pImp);
- person->Sex=cSex;
- }
- wchar_tCPerson::GetSex()
- {
- Person^person=GetImpObj(m_pImp);
- returnperson->Sex;
- }
- voidCPerson::SetAge(intiAge)
- {
- Person^person=GetImpObj(m_pImp);
- person->Age=iAge;
- }
- intCPerson::GetAge()
- {
- Person^person=GetImpObj(m_pImp);
- returnperson->Age;
- }
- wchar_t*CPerson::GetLastError()
- {
- Person^person=GetImpObj(m_pImp);
- wchar_t*pLastError=static_cast<wchar_t*>(Marshal::StringToHGlobalUni(person->LastError).ToPointer());
- wcscpy_s(m_szLastError,pLastError);
- Marshal::FreeHGlobal(System::IntPtr(pLastError));
- returnm_szLastError;
- }
现在对上面代码中所用到的一些相关背景知识进行一下介绍。
GCHandle结构提供从非托管内存访问托管对象的方法。
GCHandle.Alloc方法(Object)为指定的对象分配Normal句柄。它保护对象不被垃圾回收。当不再需要GCHandle时,必须通过Free将其释放。Normal句柄类型表示不透明句柄,这意味着无法通过此句柄解析固定对象的地址。可以使用此类型跟踪对象,并防止它被垃圾回收器回收。当非托管客户端持有对托管对象的唯一引用(从垃圾回收器检测不到该引用)时,此枚举成员很有用。
上面的代码中,在类CPerson的构造函数中用GCHandle为C#类Person的对象分配一个句柄,并将该句柄转换为void指针存放在成员变量中,以保证这个对象不会被垃圾回收器回收。然后在类CPerson的析构函数中释放这个句柄,将C#类Person的对象的回收权交给系统。
Marshal类提供了一个方法集,这些方法用于分配非托管内存、复制非托管内存块、将托管类型转换为非托管类型,此外还提供了在与非托管代码交互时使用的其他杂项方法。
Marshal..::.StringToHGlobalUni方法向非托管内存复制托管String的内容。StringToHGlobalUni对于自定义封送处理或者在混合托管和非托管代码时很有用。由于该方法分配字符串所需的非托管内存,因此应始终通过调用FreeHGlobal释放内存。
(更多关于上面介绍的背景知识可以搜索MSDN。说实在的MSDN真是一个宝库!VS能在Windows平台开发中取得绝大多数的份额,除了因为它和Windows都是微软开发的之外,MSDN的完备性功不可没!)
通过上面的方法,就把一个C#编写的类Person用托管C++给封装成了一个C++可以使用的CPerson类。我们可以在C++的工程中像使用一般的C++类一样使用类CPerson。比如下面的代码。
- CPersonperson(_T("StarLee"),'M',28);
- person.SetName(_T("StarLee"));
- person.SetSex('M');
- person.SetAge(28);
- wcout<<"Name:"<<person.GetName()<<"Sex:"<<person.GetSex()<<"Age:"<<person.GetAge()<<endl;
- wcout<<"Error:"<<person.GetLastError()<<endl;