So erstellen Sie eine /// Zusammenfassung

74

Wie generiere ich solche Zusammenfassungen in Visual Studio?

/// <summary>
///  Returns a number
/// </summary>
/// <param name="num"></param>
/// <returns></returns>
user710502
quelle
Warum willst du das tun? Dies fügt Ihrem Code Rauschen hinzu. bestenfalls ist es eine ärgerliche Vervielfältigung, aber normalerweise, da niemand diese Dinge liest, sind sie veraltet.
TamaMcGlinn

Antworten:

118

Geben Sie ///vor Ihrer Methode, Eigenschaft usw. ein. VS generiert die Kommentarblöcke automatisch.

George Johnston
quelle
8
Pedantismus: Visual Studio generiert diese Kommentarblöcke automatisch. Diese Funktion hat nichts mit der C # -Sprache selbst zu tun.
Qid
3
Das ist, warum es eine
Neulingfrage
6
@user Es ist immer noch eine gute Frage. Ansonsten lernst du es zumindest bei mir nur zufällig.
George Johnston
22

Wie bereits erwähnt, fügt Visual Studio die Dokumentationsvorlage standardmäßig automatisch hinzu, wenn Sie drei Schrägstriche hintereinander über der Elementdeklaration eingeben. Wenn auf das Mitglied Attribute angewendet wurden, geben Sie die Schrägstriche in die Zeile über den Attributen ein.

Beachten Sie jedoch, dass eines der nützlichsten Dinge, die für eine Methode (oder einen Konstruktor, eine Eigenschaft usw.) dokumentiert werden müssen, die Ausnahmen sind, die die Methode möglicherweise generiert. Diese können durch Eingabe ///<exceptionnach dem Rest der Dokumentation hinzugefügt werden . Wenn Sie den Intellisense-Vorschlag akzeptieren, erhalten Sie einen Platz für den Ausnahmetyp als XML-Attribut, und Sie können die Umstände im Inhalt des Ausnahmeelements eingeben.

Wenn einer Methode Parameter hinzugefügt werden, nachdem die Dokumentation bereits erstellt wurde, ist Intellisense auch sehr hilfreich, wenn Sie den neuen Parameternamen eingeben, wenn Sie ihn zur Dokumentation hinzufügen. Es ist eine ziemlich raffinierte Funktion.

Jeffrey L Whitledge
quelle
7

Verwenden Sie Tools wie GhostDoc . Es wird generiert, indem Sie mit der rechten Maustaste auf einen Methodennamen klicken.

Anuraj
quelle
6

Ich kann GhostDoc empfehlen , um dies noch einfacher zu machen.

Magnus
quelle
5

Geben Sie dreimal / ein, und Visual Studio füllt den Rest des Codes aus.

Vlad Bezden
quelle
5

Wie George sagt, wird /// in der Zeile oben automatisch generiert.

Abgesehen von der Kommentarvorlage für das Boilerplate würde ich empfehlen, einen Blick auf die anderen Tags zu werfen, die Sie möglicherweise verwenden: http://msdn.microsoft.com/en-us/library/5ast78ax.aspx

Dies kann in Kombination mit anderen Tools wie Sandcastle verwendet werden, um automatisch CHM-Anleitungen usw. zu erstellen.

jglouie
quelle
4

Setzen Sie den Cursor auf die Zeile direkt vor der Methode oder Klasse, die Sie dokumentieren möchten, und geben Sie "///" ein. Visual Studio generiert die XML-Dokument-Tags, und Sie können die Details eingeben.

FishBasketGordo
quelle
3

Geben Sie in der Zeile vor Ihrer Eigenschaft / Methode / etc einfach /// ein, und Visual Studio fügt die XML-Tags automatisch hinzu.

Keith
quelle
1

Für Controller: Verwenden Sie 3 Schrägstriche vor Methoden, dh ///, wodurch ein solches Zusammenfassungs-Tag generiert wird.

     /// <summary>
     /// 
     /// </summary>
     /// <param name="searchKey"></param>
     /// <returns></returns>

Für Modelle: Verwenden Sie 3 Schrägstriche vor einer automatischen Eigenschaft, dh ///, die ein Zusammenfassungs-Tag wie dieses generiert.

     /// <summary>
     /// 
     /// </summary>
Bijaya Pandey
quelle