<summary>
The <summary>
tag should be used to describe a type or a type member. Use <remarks>
to add supplemental information to a type description.
Syntax
/// <summary>description</summary>
Parameters
description
A summary of the object.
Remarks
The text for the <summary>
tag is the only source of information about the type in IntelliSense, and is also displayed in the Object Browser and in the Code Comment Web Report.
Compile with /doc
to process documentation comments to a file.
Example
// xml_summary_tag.cpp
// compile with: /LD /clr /doc
// post-build command: xdcmake xml_summary_tag.dll
/// Text for class MyClass.
public ref class MyClass {
public:
/// <summary>MyMethod is a method in the MyClass class.
/// <para>Here's how you could make a second paragraph in a description. <see cref="System::Console::WriteLine"/> for information about output statements.</para>
/// <seealso cref="MyClass::MyMethod2"/>
/// </summary>
void MyMethod(int Int1) {}
/// text
void MyMethod2() {}
};