2017-07-31 19 views
0

我在VS2015中創建了一個Asp.net api。該地區內部> HelpPage> App_Start> HelpPageConfig.cs我註釋掉線37自記文件asp.net api

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

有在項目的App_Data文件夾沒有XmlDocument.xml所以我創建了一個與我見過的自XML文檔的標籤在其他apis

<?xml version="1.0" encoding="utf-8" ?> 
<doc> 
    <assembly> 
    <name>NameOfApiHere</name> 
    </assembly> 
    <members> 
    </members> 
</doc> 

但是,當建設和/或運行應用程序什麼都沒有進入xml。我的理解是,如果打開XML sel文檔,它基於給定方法的每個///摘要,並且對任何沒有摘要但沒有明確複製的任何公共方法的公開方法發出intellisense警報摘要信息作爲「成員」標籤內的「成員」標籤,這個XML也不會發生。我錯過了什麼步驟,我沒有看到如何在互聯網上打開APi中的自我文檔?

回答

1

在項目propeties中將XML documentation destintion文件夾重新命名爲您所需的文件夾。我想應該使用app_data而不是App_code文件夾。

看看到第1和this question answer

+0

這使我想起它,它是在unter build的屬性中,我不得不同時檢查「XML Documentation file:」並將路徑設置爲我的xml – davidp04

+0

您是否嘗試將文件夾更改爲'app_data'?無論如何'XmlDocumentationProvider'在你的項目中調試它,你會明白爲什麼它不起作用 – ASpirin

+0

是的,它是在App_data中,App_Code是一個錯字,我會糾正 – davidp04

0

嘗試刪除XmlDocument.xml文件,您添加的(我認爲這會自動生成),並指定在項目設置的路徑,它的第二個步驟 - >生成選項卡中的輸出內部分。