ASP.NET Web API如何將注釋自動生成幫助文檔
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 代碼的注釋,修改一下路徑:
然后重新編譯,訪問 /help 頁面,就能看到效果了。
config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/OpenAPI.xml")))
通過以上的簡單介紹,希望對大家有所幫助
相關文章
Asp.net MVC中使用JQuery插件ajaxFileUpload上傳文件
這篇文章主要介紹了Asp.net MVC中使用JQuery插件ajaxFileUpload上傳文件,需要的朋友可以參考下2016-08-08Equals和==的區(qū)別 公共變量和屬性的區(qū)別小結
Equals 和==的區(qū)別 公共變量和屬性的區(qū)別 總結一下。2009-11-11詳解.NET中的加密算法總結(自定義加密Helper類續(xù))
這篇文章主要介紹了詳解.NET中的加密算法總結(自定義加密Helper類續(xù)) ,具有一定的參考價值,感興趣的小伙伴們可以參考一下。2016-12-12javascript判斷是否有對RadioButtonList選項選擇
寫個Javascript來判斷是否有對RadioButtonList選項選擇,附動畫演示,感興趣的朋友可以了解下,希望對您們有幫助2013-01-01