2011-10-21 24 views
3

我在一個解決方案中有一個包含兩個命名空間的C#項目。我已經記錄了兩個名稱空間中的所有類/函數/成員/等。由於此項目是一個小型研究項目,名稱空間爲DocTestLibraryDocTestLibrary.Events。但是,當我嘗試通過Sandcastle從它創建文檔時,它只會爲DocTestLibrary命名空間創建文檔。我有什麼需要在沙堡進行這項工作?儘管如此,我仍然懷疑它的存在,正如我在其中大部分研究過的。並非所有命名空間都包含在Sandcastle版本中用於文檔

奇怪的是,Doxygen能夠生成文檔就好了。


至於提供一些更多的信息,我已經檢查了Sandcastle爲構建產生的日誌。 看來這個條目導致其餘的不被顯示。

Warn: ResolveReferenceLinksComponent2: Unknown reference link target 'T:DocTestLibrary.Events.DemoEvent'. 

我也發現了別的。

DocTestLibrary命名空間包含兩個類:

  • 的TestClass
  • StaticHelper

顧名思義,該StaticHelper是一個輔助類,只有靜態方法。但Sandcastle也否認處理這個文件。只有TestClass get被處理。它只是讓我覺得日誌裏沒有關於這個的條目。

回答

1

通過在Sandcastle項目的Visibility屬性部分中設置DocumentInternals,似乎可以解決此問題。我不知道這是爲什麼,因爲沒有代碼被宣佈內部...

我想我會打周圍的一些更多...

2

您是否在DocTestLibrary.Events內部有任何類型?默認情況下,我相信Sandcastle只會生成公共類型的文檔。

+0

除了兩個私人字符串外,一切都被公開宣佈。沒有聲明是內部的。 – ThaMe90

+0

這確實讓我想到了我正在尋找的答案,謝謝。 – ThaMe90

+1

@ ThaMe90:你明白,非嵌套類的默認*可見性是內部的,而不是公共的,對嗎?所以只是'Foo類'是一個內部類。 –

8

我知道這是有點高插孔。但如果有人仍然有這個問題:

在我的沙堡項目將只包括總5.
問題單個命名空間是我沒有檢查部分幫助文件在include根命名空間容器


現在我所有的名稱空間都列在根名稱空間之外。

1

我發現這個問題可以通過在項目屬性 - >可見性下手動設置編輯API過濾器中記錄的類來解決。

相關問題