C++/CLI 托管C++之导出注释【11】

---

Git 源码地址

 

C++/CLI 托管C++的托管与非托管字符串的相互转换【1】

C++/CLI 托管C++的数据类型介绍【2】

C++/CLI 托管C++的基本数据类型及函数【3】

C++/CLI 托管C++的数组介绍【4】

C++/CLI 托管C++之字符串封装【5】

C++/CLI 托管C++之enum枚举封装【6】

C++/CLI 托管C++之类、属性封装【7】

C++/CLI 托管C++之结构体封装【8】

C++/CLI 托管C++之结构体封装(内存对齐#pragma pack)【9】

C++/CLI 托管C++之联合体union封装【10】

C++/CLI 托管C++之导出注释【11】

C++/CLI signing snk文件强命名

---

将封装好的CLI Dll提供给NET使用时，当然少不了注释的添加。本文就是介绍使用XML注释的方式，获取Dll对应的注释。涉及两点：

 【1】CLI的成员的注释需要按照标准的方式进行添加，简单点就是C#怎样添加注释///, CLI也要按照同样的方式添加，如下图：

/// <summary>
/// 1 字符串测试类
/// </summary>
public ref class StrCls
{
public:
    /// <summary>
    /// 1.1 字符串作为输入参数
    /// </summary>
    /// <param name="pInStr">字符串</param>  
    /// <returns>成功返回0</returns> 
    static Int32 StrOutput(String^ pInStr);       
    /// <summary>
    /// 1.2 字符串作为参数,需要进行修改返回
    /// </summary>
    /// <param name="pOutStr">字符串</param>  
    /// <returns>成功返回0</returns> 
    static Int32 StrChange(String^ %pOutStr);        
    /// <summary>
    /// 1.3 字符串数组作为参数
    /// </summary>
    /// <param name="ppStr">字符串数组</param>  
    /// <returns>成功返回0</returns> 
    static Int32 StrChangeArr(array<String^>^ %ppStr);
};

【2】需要在项目的配置中，选择配置生成XML文件（项目--属性）

【3】重新编译项目，即可看到在Dll的同目录下，生成了相应的XMl注释，使用时XML与Dll需要在同目录下。