2014-03-27 10 views
6

Also erzeuge ich eine Dokumentationswebsite mit Sandcastle Help File Builder. Alles ist großartig! Wenn ich jedoch eine Seite für eine Klasse anschaue, möchte ich für die Eigenschaftentabelle (die derzeit die Spalten icon, name und description enthält, siehe unten) eine Spalte für den Typ der Eigenschaft (int, bool, string) einfügen , etc).Hinzufügen von Typspalte zu Sandcastle-Eigenschaftentabelle

Properties Table

Ich war irgendwo über die XSL-Dateien zu lesen, die für die Vorlagen verwendet werden, aber es war ehrlich gesagt ein wenig überwältigend versuchen, genau das zu finden, was ich suche.

Also im Grunde möchte ich eine Spalte zu der obigen Tabelle hinzufügen, die den Typ (String, Int, etc) auflistet. Ist das möglich? Vielen Dank!

+0

Es ist möglich, den Typ manuell in die Beschreibung einzufügen, indem Sie im Zusammenfassungskommentar ein -Tag verwenden. http://msdn.microsoft.com/en-us/library/acd0tfbe.aspx – Darragh

+0

Haben Sie das jemals herausgefunden? Ich kam hierher, um genau diese Frage zu stellen. – thinklarge

+0

Nicht ganz. Das Beste, was ich mir vorstellen konnte, war der Vorschlag von @Darragh. Ich werde eine Antwort mit einigen Details veröffentlichen. – jmgardn2

Antwort

1

Leider habe ich nach vielen Suchen immer noch keine Möglichkeit gefunden, genau das zu tun, was ich wollte (als separate Spalte). Das Beste, wie Darraugh sagte, ist, es manuell in die Beschreibung aufzunehmen. Es gibt zwei Möglichkeiten, dies zu tun. Verwenden Sie die oder verwenden Sie die <seealso> tag.

/// <summary> 
/// Assessment ID to be copied 
/// <see cref="System.Int32">System.Int32</see> 
/// </summary> 

und produziert die folgenden:

/// <summary> 
/// Assessment ID to be copied 
/// <seealso cref="System.Int32"/> 
/// </summary> 

: kann

<see> tag sample

Die <seealso> Tag als solche verwendet werden

Der <see> Tag kann als solche verwendet werden Und produziert das Folgen ing:

<seealso> tag sample

Dies ist ein wenig überflüssig ist, da Sie in die Eigenschaft, um es zu sehen, gehen, die bereits den Objekttyp anzeigt.

Hoffentlich wird diese Antwort irgendwann obsolet werden, wenn dies in Sandcastle selbst implementiert wird. Aber gerade jetzt kann dies anderen helfen, da es mir geholfen hat.