ASP.NET Web API從注釋生成幫助文檔


默認情況下,ASP.NET Web API不從Controller的注釋中生成幫助文檔。如果要將注釋作為Web API幫助文檔的一部分,比如在幫助文檔的Description欄目中顯示方法注釋中的summary,需要進行一些配置操作。

首先在Visual Studio中打開Web API項目的屬性頁,在Build設置頁,選中XML document file,輸入將要生成的XML文件放置的路徑,比如:App_Data\OpenAPI.XML。

然后編譯項目,就會在對應的路徑下生成xml文件。

接着打開 Areas\HelpPage\App_Start\HelpPageConfig.cs 文件,取消 config.SetDocumentationProvider 代碼的注釋,修改一下路徑:

config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/OpenAPI.xml")));

然后重新編譯,訪問 /help 頁面,就能看到效果了。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM