c# - 如何使用沙堡在输出中标记过时的类/方法

Question

我正在使用 Sandcastle 构建 API 文档。该代码有多个标记为已弃用的类和方法。现在我希望在 API 文档输出中清楚地标记这些方法（划掉或其他标记）。但是，Sandcastle 输出根本没有标记过时的方法/类。

我的问题是。我需要做什么才能让 Sandcastle 标记过时的方法/类。

感谢您的任何建议/帮助。

Answer 1

好吧，我发现了这个问题。问题是我使用的 API 和属性过滤器的混合。

所以我将 System-namespace 添加到我的 API 过滤器中，以便它包含 Obsolete-Attribute：

<apiFilter>
  <namespace name="System" expose="true">
    <type name="ObsoleteAttribute" expose="true" />
    <type name="SerializableAttribute" expose="false" />
  </namespace>
  <!-- rest of the stuff -->
</apiFilter>

并将其添加到 Attribute-Filters 列表中：

<attributeFilter expose="true">
  <namespace name="System" expose="false">
    <type name="ObsoleteAttribute" expose="true" />
  </namespace>
  <!-- rest of the stuff -->
</attributeFilter>

我的属性过滤器中有“ObsoleteAttribute”，但在 API 过滤器中没有。

这个线程也很有帮助：http ://docproject.codeplex.com/discussions/74716?ProjectName=docproject