May 2008
Intermediate to advanced
248 pages
3h 50m
German
Ein Dokumentationskommentar ist ein Stück eingebettetes XML, das einen Typ oder einen Member dokumentiert. Ein Dokumentationskommentar steht direkt vor einer Deklaration des Typs oder Members und beginnt mit drei Schrägstrichen (Slashes):
/// <summary>Beendet eine laufende Abfrage.</summary>
public void Cancel( ) { ... }Kommentare über mehrere Zeilen können entweder so geschrieben werden:
/// <summary>
/// Beendet eine laufende Abfrage.
/// </summary>
public void Cancel( ) { ... }oder so (beachten Sie das zusätzliche Sternchen am Anfang):
/**<summary> Beendet eine laufende Abfrage. </summary>*/public void Cancel( ) { ... }
Wenn Sie mit der Direktive /doc kompilieren, extrahiert der Compiler die Dokumentationskommentare und sammelt ...