「/// <exclude/>」是什麼意思？

Question

我已經繼承了一堆C＃代碼。對於幾個方法定義，我發現///<exclude/>是它前面的唯一XMLDoc。我試圖谷歌的意思，但沒有成功。有人可以解釋這可能意味着什麼嗎？

Answer 1

至少在NDoc這意味着該成員的XML文檔應該被排除。來自documentation：

<exclude/>標記指示NDoc從文檔中排除當前項目。

我不清楚這是否最初是NDoc特定的，但它似乎也支持Sandcastle（因爲它在Sandcastle XML comments guide）。

Answer 2

從Sandcastle Help File Builderdocumentation：

命名空間通過命名空間摘要屬性排除或 項目被排除在外，因爲它的XML註釋包括<排除/ > 標籤。此信息與API過濾器 設置自動合併。要更改這些項目，您需要使用名稱空間 Summaries屬性或從項目的XML註釋中移除標籤。

正式答覆：

A way to exclude documentation?

而且更多信息有關的行爲：

Problems with missing members and tag