XML-Dokumentationskommentare (C#-Programmierhandbuch)

Aktualisiert: November 2007

In Visual C# lässt sich eine Dokumentation des Codes erstellen. Dazu werden XML-Tags in spezielle Kommentarfelder des Quellcodes unmittelbar vor dem Codeblock eingefügt, auf den sie sich beziehen. Beispiel:

/// <summary>
///  This class performs an important function.
/// </summary>
public class MyClass{}

Wenn Sie mit /doc kompilieren, sucht der Compiler alle XML-Tags im Quellcode und erstellt eine XML-Dokumentationsdatei.

Hinweis:
XML-Dokumentkommentare sind keine Metadaten und sind nicht in der kompilierten Assembly enthalten. Folglich ist der Zugriff auf sie über Reflektion nicht möglich.

In diesem Abschnitt

• Empfohlene Tags für Dokumentationskommentare

• Verarbeiten der XML-Datei

• Trennzeichen für Dokumentationstags

• Gewusst wie: Verwenden der XML-Dokumentationsfeatures

Verwandte Abschnitte

Weitere Informationen finden Sie unter folgenden Themen:

• /doc (Dokumentationskommentare verarbeiten)

• Beispiel für die XML-Dokumentation

C#-Programmiersprachenspezifikation

Weitere Informationen finden Sie in den folgenden Abschnitten von C#-Programmiersprachenspezifikation:

• Anhang A "Dokumentationskommentare"

Siehe auch

Konzepte

C#-Programmierhandbuch