VS 2017 WebAPI Help Page - No Document Provided

前端 未结 3 1476
春和景丽
春和景丽 2021-01-13 18:18

I have followed the steps at MSDN, and other SO questions, to setup documenting and to have the XML comments show in the descriptions section of the help page. However, I am

3条回答
  •  北海茫月
    2021-01-13 19:16

    I know this answer comes very late, but I ran into the same problem. I could not get Visual Studio 2017 to output the XML Documentation file to the suggested ~/App_Data/XmlDocument.xml location.

    However, I found that the correct file is generated under ~/bin/.xml. So if your project is "TestWebAPI2", then this file should be ~/bin/TestWebAPI2.xml.

    (I couldn't see if there was a way to move/copy this file to ~/App_Data, but I didn't look for a very long time)

    To get this working, go to ~/Areas/HelpPage/App_Start/HelpPageConfig.vb and change the following line to suit:

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

    becomes

    config.SetDocumentationProvider(New XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/bin/.xml")))
    

    (don't forget to replace with your WebAPI2 project name)

提交回复
热议问题