XML in Csharp code?

[ozgur develioglu]

Why do you use XML code in c# code like;
/// <summary>

/// Execute a SqlCommand (that returns no resultset) against the database
specified in the connection string

/// using the provided parameters

/// </summary>

/// <remarks>

/// e.g.:

/// int result = ExecuteNonQuery(connString, CommandType.StoredProcedure,
"PublishOrders", new SqlParameter("@prodid", 24));

/// </remarks>

/// <param name="connectionString">A valid connection string for a
SqlConnection</param>

/// <param name="commandType">The CommandType (stored procedure, text,
etc.)</param>

/// <param name="commandText">The stored procedure name or T-SQL
command</param>

/// <param name="commandParameters">An array of SqlParamters used to execute
the command</param>

/// <returns>An int representing the number of rows affected by the
command</returns>

What do they serve?

[Jack Meyhoff]

Its for automatic documentating, you can auto generate docuementing for APIs
and class libraries in various forms by running it thru a style sheet, want
HTML , not a problem. Its a good thing. Use it.
"ozgur develioglu" <oz*************@yahoo.com> wrote in message
news:uw**************@TK2MSFTNGP12.phx.gbl...

Why do you use XML code in c# code like;
/// <summary>

/// Execute a SqlCommand (that returns no resultset) against the database
specified in the connection string

/// using the provided parameters

/// </summary>

/// <remarks>

/// e.g.:

/// int result = ExecuteNonQuery(connString, CommandType.StoredProcedure,
"PublishOrders", new SqlParameter("@prodid", 24));

/// </remarks>

/// <param name="connectionString">A valid connection string for a
SqlConnection</param>

/// <param name="commandType">The CommandType (stored procedure, text,
etc.)</param>

/// <param name="commandText">The stored procedure name or T-SQL
command</param>

/// <param name="commandParameters">An array of SqlParamters used to execute the command</param>

/// <returns>An int representing the number of rows affected by the
command</returns>

What do they serve?

[Wim Hollebrandse]

In addition to what Jack mentioned - check out the free Ndoc utility which
generates MSDN style documentation based on your C# XML comments.

You can find it at: http://ndoc.sourceforge.net/

Cheers,
Wim Hollebrandse

--
Wimdows Components
..NET components - professional, robust and affordable.
http://www.wimdows.com
--
"ozgur develioglu" <oz*************@yahoo.com> wrote in message
news:uw**************@TK2MSFTNGP12.phx.gbl...

Why do you use XML code in c# code like;
/// <summary>

/// Execute a SqlCommand (that returns no resultset) against the database
specified in the connection string

/// using the provided parameters

/// </summary>

/// <remarks>

/// e.g.:

/// int result = ExecuteNonQuery(connString, CommandType.StoredProcedure,
"PublishOrders", new SqlParameter("@prodid", 24));

/// </remarks>

/// <param name="connectionString">A valid connection string for a
SqlConnection</param>

/// <param name="commandType">The CommandType (stored procedure, text,
etc.)</param>

/// <param name="commandText">The stored procedure name or T-SQL
command</param>

/// <param name="commandParameters">An array of SqlParamters used to execute the command</param>

/// <returns>An int representing the number of rows affected by the
command</returns>

What do they serve?

[Noah Coad [MVP & MCP]]

And the most obvious (and quick result) reason...
The VS.NET IDE shows those commend when you use the class and AutoComplete.

You've seen documentation when using a class and pressing "." after it, like
this:
Console.WriteLine(
Well the IDE will use those XML comments to do the same with your code.

-Noah Coad
Microsoft MVP & MCP

"ozgur develioglu" <oz*************@yahoo.com> wrote in message
news:uw**************@TK2MSFTNGP12.phx.gbl...

Why do you use XML code in c# code like;
/// <summary>

/// Execute a SqlCommand (that returns no resultset) against the database
specified in the connection string

/// using the provided parameters

/// </summary>

/// <remarks>

/// e.g.:

/// int result = ExecuteNonQuery(connString, CommandType.StoredProcedure,
"PublishOrders", new SqlParameter("@prodid", 24));

/// </remarks>

/// <param name="connectionString">A valid connection string for a
SqlConnection</param>

/// <param name="commandType">The CommandType (stored procedure, text,
etc.)</param>

/// <param name="commandText">The stored procedure name or T-SQL
command</param>

/// <param name="commandParameters">An array of SqlParamters used to execute the command</param>

/// <returns>An int representing the number of rows affected by the
command</returns>

What do they serve?

[Jack Meyhoff]

Its called "intellisense".
"Noah Coad [MVP & MCP]" <no**@coad.net> wrote in message
news:#e**************@TK2MSFTNGP10.phx.gbl...

And the most obvious (and quick result) reason...
The VS.NET IDE shows those commend when you use the class and AutoComplete.
You've seen documentation when using a class and pressing "." after it, like this:
Console.WriteLine(
Well the IDE will use those XML comments to do the same with your code.

-Noah Coad
Microsoft MVP & MCP

"ozgur develioglu" <oz*************@yahoo.com> wrote in message
news:uw**************@TK2MSFTNGP12.phx.gbl...

Why do you use XML code in c# code like;
/// <summary>

/// Execute a SqlCommand (that returns no resultset) against the database specified in the connection string

/// using the provided parameters

/// </summary>

/// <remarks>

/// e.g.:

/// int result = ExecuteNonQuery(connString, CommandType.StoredProcedure, "PublishOrders", new SqlParameter("@prodid", 24));

/// </remarks>

/// <param name="connectionString">A valid connection string for a
SqlConnection</param>

/// <param name="commandType">The CommandType (stored procedure, text,
etc.)</param>

/// <param name="commandText">The stored procedure name or T-SQL
command</param>

/// <param name="commandParameters">An array of SqlParamters used to

execute

the command</param>

/// <returns>An int representing the number of rows affected by the
command</returns>

What do they serve?