<seealso>
documentation tag
The <seealso>
tag lets you specify the text that you might want to appear in a See Also section. Use <see>
to specify a link from within text.
Syntax
/// <seealso cref="member"/>
Parameters
member
A reference to a member or field that is available to be called from the current compilation environment. Enclose the name in single or double quotation marks.
The compiler checks that the given code element exists and resolves member
to the element name in the output XML. The compiler issues a warning if it doesn't find member
.
For information on how to create a cref
reference to a generic type, see <see>
.
Remarks
Compile with /doc
to process documentation comments to a file.
See <summary>
for an example of using <seealso>
.
The MSVC compiler attempts to resolve cref
references in one pass through the documentation comments. If the compiler doesn't find a symbol when using the C++ lookup rules, it marks the reference as unresolved.
Example
In the following sample, an unresolved symbol is referenced in a cref
. The XML comment for the cref
to A::Test
is well formed: <seealso cref="M:A.Test" />
. However, the cref
to B::Test
becomes <seealso cref="!:B::Test" />
.
// xml_seealso_tag.cpp
// compile with: /LD /clr /doc
// post-build command: xdcmake xml_seealso_tag.dll
/// Text for class A.
public ref struct A {
/// <summary><seealso cref="A::Test"/>
/// <seealso cref="B::Test"/>
/// </summary>
void MyMethod(int Int1) {}
/// text
void Test() {}
};
/// Text for class B.
public ref struct B {
void Test() {}
};