La pagina della guida dell'API Web non mostra XML

Question

Ho un progetto API Web in cui ho rimosso a mano la cartella Aree alcuni mesi fa quando abbiamo iniziato lo sviluppo. Ora, dopo che tutto è finito, voglio aggiungere le pagine di aiuto dell'API ma non funziona come previsto.

Ho installato il pacchetto nuget per le pagine della guida.

ho riga non commentata in HelpPageConfig.cs

ho controllato generare file di documentazione (nella cartella App_Data)

Quando apro http://localhost:51665/help ottengo questo: (No Metodi sono mostrati)

Qualche idea di cosa potrebbe essere sbagliato? Se avvio da zero un nuovo progetto, tutto funziona correttamente.

Answer 1

suppongo si imposta'VE il progetto in due fasi:

1. Si consiglia di scegliere Costruire scheda nel progetto API Proprietà e creare file di documentazione XML in uscita sezione. Per esempio: App_Data\XmlDocument.xml
2. poi si può aggiornare HelpPageConfig.cs nel metodo Register ... nel mio caso

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

• Quando il progetto è in corso di compilazione, date un'occhiata a finestra di output, se la documentazione è veramente generata.

• Provare a utilizzare la versione precedente delle pagine della Guida di ASP.NET (la versione 5.2.2 funziona per me).

  Install-Package Microsoft.AspNet.WebApi.HelpPage -Version 5.2.2