<see> (Visual C++)
<see> 标记使您得以从文本内指定链接。 使用 <seealso> 指示文本您可能希望中显示区分请参见。
<see cref="member"/>
参数
member
对可以通过当前编译环境进行调用的成员或字段的引用。 名称括在单引号或双引号。编译器将检查特定代码元素是否存在并解决 member 到输出 XML 元素名称。 如果它没有找到 member,编译器会发出警告。
备注
使用 /doc 进行编译可以将文档注释处理到文件中。
有关使用示例 <see>参见 <summary>。
Visual C++ 编译器在一个处理过程将尝试解决 cref 引用传递文档注释。 因此,因此,如果使用 C++ 查找规则,编译器没有找到符号引用将被标记为未解析。 有关更多信息,请参见<seealso> (Visual C++)。
示例
下面的示例演示如何使 cref 对泛型类型,因此,编译器将引用解析。
// xml_see_cref_example.cpp
// compile with: /LD /clr /doc
// the following cref shows how to specify the reference, such that,
// the compiler will resolve the reference
/// <see cref="C{T}">
/// </see>
ref class A {};
// the following cref shows another way to specify the reference,
// such that, the compiler will resolve the reference
/// <see cref="C < T >"/>
// the following cref shows how to hard-code the reference
/// <see cref="T:C`1">
/// </see>
ref class B {};
/// <see cref="A">
/// </see>
/// <typeparam name="T"></typeparam>
generic<class T>
ref class C {};