What are XML Comments in C# Used For?

Question

Possible Duplicate:
What are the virtues of using XML comments in .NET?

/// <summary>
///  Set error message for multilingual language.
/// </summary>

What is the use of XML Comments like the above in C# and when do i use them.. XML Comments come with 3 Quotes , Is there a block commenting process for XML Comments like /* ... */

MSDN tells you: http://msdn.microsoft.com/en-us/library/b2s063f7.aspx. They are for documentation purposes. They are also used by intellisense. — Simon Whitehead, Jan 22 '13 at 02:08

score 5 · Accepted Answer · answered Jan 22 '13 at 02:09

XML comments are a structured way to document the types and members within your code. If you use this, the compiler will generate XML documentation for your types and members, which can then be processed via a tool like Sandcastle to build help automatically. The information in the generated XML files is also used by Visual Studio (to provide intellisense).

You can use multiline delimiters via:

/** <summary>
Your info here
*/

Although the tooling doesn't generate it in this form.

For details, see XML Documentation Comments on MSDN.

score 2 · Answer 2 · answered Jan 22 '13 at 02:10

2

Its a way to document your code. here is a reference

http://msdn.microsoft.com/en-us/magazine/dd722812.aspx

answered Jan 22 '13 at 02:10

Ricky Gummadi

4,559
2
41
67

What are XML Comments in C# Used For?

2 Answers2