ASP.NET Web API Генерация всех параметров из модели - страницы помощи
Я занят созданием веб-API (внутри приложения asp mvc4). Я использую библиотеку, предложенную на сайте asp.net для создания документации (http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages).
Моя проблема в том, что если мой параметр - модель, то я не могу указать, какие свойства содержит модель на сгенерированных страницах справки.
Вот пример:
МОДЕЛЬ:
public class TestModel
{
property String FirstName {get;set;}
property String Surname {get; set;}
property Boolean Active {get;set;}
}
ДЕЙСТВИЕ:
/// <summary>
/// This is a test action
/// </summary>
/// <param name="model">this is the model</param> <-- this works
/// <param name="FirstName">This is the first name </param> <-- doesn't work
/// <param name ="model.Surname">This is the surname</param> <-- doesn't work
public HttpResponseMessage Post(my.namespace.models.TestModel model)
{
...
}
Генерируется только параметр для модели.
Я посмотрел на XML-документ, который генерируется для документации, и он добавляет другие параметры.
<member name="my.namespace.api.Post(my.namespace.models.TestModel)">
<summary>
this is a test action
</summary>
<param name="model>this is the model</param>
<param name="FirstName">This is the first name </param>
<param name="model.Surname">This is the surname</param>
</member>
Но на страницах справки он только генерирует модель параметров.
Я проследил это до метода, где он получает параметры из XML.
Collection<ApiDescription> apiDescriptions = config.Services.GetApiExplorer().ApiDescriptions;
Это находится в HelpPageConfigurationExtentions.cs, который генерируется автоматически.
Я подхожу к этому неправильно? Кто-нибудь знает об обходной путь?
Любые предложения или решения будут оценены.