Le langage C# permet de documenter les classes d'une application en utilisant des commentaires spéciaux juste avant la déclaration de l'élément concerné (espace de noms, classe, interface, méthode, propriété, attribut).
Syntaxe.
Les commentaires de documentation commencent par un triple slash codice_1 et se termine au prochain retour à la ligne.
Le contenu de ces commentaires est au format XML. Il est possible d'utiliser plusieurs lignes.
Exemple :
/// <summary>
/// Une classe pour démontrer
/// les commentaires de documentation
/// </summary>
public class Exemple
 ...
Depuis la version 2003 du compilateur C# (pour la normalisation ECMA), il est également possible d'utiliser des blocs de commentaires codice_2 :
 <summary>
 Une classe pour démontrer
 les commentaires de documentation
 </summary>
public class Exemple
 ...
Il est possible de mélanger les deux styles, mais non recommandé pour la lisibilité du code :
 <summary>
 Une classe pour démontrer
 les commentaires de documentation
/// </summary>
public class Exemple
 ...
Générer la documentation.
Le compilateur C# est capable de générer un fichier XML à partir des fichiers sources.
Exemple :
 csc /doc:exemple.xml exemple.cs
Balises XML standards.
Quelques balises XML sont utilisées couramment. Les balises suivantes sont placées en dehors de toute autre :
Les balises suivantes sont placées à l'intérieur de celles décrites ci-dessus pour formater le texte :
Il est également possible d'ajouter ses propres balises XML.
La balise codice_22 contient les balises suivantes :
Ces balises contiennent :
L'attribut codice_27 peut en fait s'appliquer à toute balise XML pour faire référence à une autre entité (classe, méthode, propriété, ...).
Il est également possible d'utiliser un fichier XML séparé pour documenter plusieurs entités, en utilisant la balise codice_28 :
Visualiser la documentation.
Visualiser directement le fichier XML tel quel n'est pas très pratique. Il est possible d'utiliser des logiciels de visualisation spécialisés, ou bien d'utiliser un navigateur supportant XML et XSL (Internet Explorer et Firefox par exemple). Pour cela, plusieurs feuilles de style ("stylesheet" en anglais) sont téléchargeables depuis internet :
Puis il faut modifier le fichier XML produit en ajoutant la ligne suivante juste après la première balise codice_30 :
<?xml-stylesheet type="text/xsl" href=""nom_du_fichier".xsl"?>
En double-cliquant sur le fichier XML sous Windows, le navigateur applique la transformation décrite par la "stylesheet" indiquée pour afficher une version HTML plus présentable que le format initial.
Cependant la feuille de transformation fournie par MSDN comporte quelques problèmes :
<xsl:template match="seealso">
 <xsl:if test="@cref">