Web API的XML幫助文檔不會更新發布

Question

根據online documentation和HelpPageConfig.cs中的註釋代碼，啓用XML文檔會將XML文件添加到〜App_data/name_of_file.xml。然後將項目構建屬性設置爲匹配該路徑。

但是，在發佈時，XML文件似乎沒有發佈，這會在訪問api的幫助頁面時導致YSOD。我已驗證該文件的構建操作已設置爲內容。我也嘗試玩複製到輸出目錄沒有任何效果。

無論如何，爲了好奇，我想知道是否有解決方案使用他們推薦的文件位置，或者它只是某種過時的推薦;否則，我想我可以嘗試將它移動到bin目錄。

我正在使用Web API 2.1幫助頁面nuget包。

Answer 1

HelpPage只需要一個有效的路徑來讀取文件，所以如果文件來自App_Data文件夾或bin文件夾，則無關緊要。

Answer 2

嘗試向Azure發佈時，我遇到了類似的問題。我必須在項目中包含幫助文檔* .xml文件，然後才能發佈。

另外，還要確保您的發佈選項「從App_Data文件夾排除文件」未選中如果你是其中採購到App_Data文件夾。