向Sandcastle属性表添加类型列。

Question

我正在使用Sandcastle Help File Builder生成文档网站。一切都生成得很好！但是，在查看类的页面时，我希望在属性表（目前具有图标、名称和描述列，如下所示）中包括一个属性类型列（int、bool、string等）。

我在某个地方读到了用于模板的xsl文件，但是找到我需要的内容有点困难。

因此，基本上，我想在上面的表格中添加一个列来列出类型（字符串、整数等）。这可能吗？谢谢！

- jmgardn2

---

可以使用在摘要注释中的<see cref="Address">标签手动包含类型。http://msdn.microsoft.com/en-us/library/acd0tfbe.aspx - Darragh

你最终解决了这个问题吗？我来到这里就是为了发表完全相同的问题。 - thinklarge

不完全是。我能想到的最好的方法是基于@Darragh的建议。我会发布一个带有一些细节的答案。 - jmgardn2

Answer 1

很遗憾，经过大量搜索，我仍然无法找到完全按照我的要求（作为单独的列）进行操作的方法。正如Darraugh所指出的那样，最好的方法是在描述中手动包含它。有两种方法可以做到这一点。使用 <See> tag 或使用 <seealso> tag。 <see>标签的使用方法如下：

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

并产生以下结果：

"

<seealso>

标签可用作如下方式："

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

并且产生以下结果：

这有点多余，因为您必须进入属性才能看到它，而属性本身已经显示了属性类型。 希望在未来，这将被实现到沙盘中，这样这个回答就会过时了。但是现在，它可能会像对我一样对其他人有所帮助。

- jmgardn2