C#注释标签
文档型注释
该类注释采用.Net已定义好的Xml标签来标记,在声明接口、类、方法、属性、字段都应该使用该类注释,以便代码完成后直接生成代码文档,让别人更好的了解代码的实现和接口。如
///
///
///
///for information about output statements.
///
///
///
public static void MyMethod(int Int1)
{
}
单行注释(略...)
注释标签*
标签 | 作用 | 用法 |
description name 为方法参数名。将此名称用单引号括起来(' ')。 | 应当用于方法声明的注释中,以描述方法的一个参数。 | |
cref = "member" 对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将 member 传递给输出XML 中的元素名。必须将 member 括在双引号 (" ") 中。 | 使您得以从文本内指定链接 | |
cref = "member" 对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将 member 传递给输出XML 中的元素名。必须将 member 括在双引号 (" ") 中 | ||
description代码示例的说明。 | 使用 标记的使用。 | |
filename 包含文档的文件名。该文件名可用路径加以限定。将 filename 括在单引号中 (' ')。 Tagpath:filename 中指向标记名的标记路径。将此路径括在单引号中 (' ')。 name 注释前边的标记中的名称说明符;名称具有一个 id。 id 位于注释之前的标记的 id。将此 id 括在双引号中 (" ")。 | ||
term 定义的项,该项将在 text 中定义。 description 目符号列表或编号列表中的项或者 term 的定义。 | 列表中的每一项用 列表或表所拥有的 | |
cref = "member" 对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将 member 转换为输出XML 中的规范化元素名。必须将 member 括在双引号 (" ") 中。 description 成员的访问的说明。 | ||
description 成员的说明。 | ||
property-description 属性的说明。 |