//对这个类写xml注释文件
/// <summary>
/// Role 的摘要说明。
/// 该类实现的接口包括 ISimpleGetPager
/// 如何使用:your description here
/// </summary>
public class Role : BizBase, ISimpleGetPager
{。。}
/// <summary>
/// Role 的摘要说明。
/// 该类实现的接口包括 ISimpleGetPager
/// 如何使用:your description here
/// </summary>
public class Role : BizBase, ISimpleGetPager
{。。}
<permission cref="member">description</permission>
其中: cref = "member"
对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将 member 转换为输出 XML 中的规范化元素名。必须将 member 括在双引号 (" ") 中。
description
对成员的访问的说明。
备注
<permission> 标记使您得以将成员的访问记入文档。System.Security.PermissionSet 使您得以指定对成员的访问。使用 /doc 进行编译可以将文档注释处理到文件中。示例
// xml_permission_tag.cs
// compile with: /doc:xml_permission_tag.xml
using System;
class TestClass
{
/// <permission cref="System.Security.PermissionSet">Everyone can access this method.</permission>
public static void Test()
{
}
public static void Main()
{
}
}
.net的同样也是用XML文档实现的帮助标记。