ASP.NET web.api 帮助页面没有显示任何描述

Question

当我运行我的程序只显示 "Provide a general description of your APIs here." 但没有显示任何内容。就像这张图：http://i.stack.imgur.com/unBmb.png

我的问题与此类似ASP.NET Web Api Help Page doesn't show any tips，但它没有提供任何解决方案。

我已按照 "Adding Help Pages to an Existing Project" 中的本教程 http://www.asp.net/web-api/overview/getting-started-with-aspnet-web-api/creating-api-help-pages 进行操作，除 "ValuesController" 外，所有内容都是从 nuGet 自动创建的。

我猜这就是问题所在。

我的值控制器：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
namespace WebApiHelperTest.Controllers
{
    public class ValuesController : ApiController
    {
        /// <summary>
        /// Gets some very important data from the server.
        /// </summary>
        public IEnumerable<string> Get()
        {
            return new string[] { "value1", "value2" };
        }

        /// <summary>
        /// Looks up some data by ID.
        /// </summary>
        /// <param name="id">The ID of the data.</param>
        public string Get(int id)
        {
            return "value";
        }

        // POST api/values
        public void Post([FromBody]string value)
        {
        }

        // PUT api/values/5
        public void Put(int id, [FromBody]string value)
        {
        }

        // DELETE api/values/5
        public void Delete(int id)
        {
        }
    }
}

有没有人对此有解决方案，或者对可能出错的地方有任何建议？

（我还制作了一个新的 asp.net web api-project（从一开始就包含了 valuescontroller），这很好..）

Answer 1

我找到了解决办法！

第 1 步：我在控制器文件夹中添加了一个 valuesController，作为一个空的 Web api2 控制器。然后粘贴教程中的代码：

using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;

namespace yournamespace.Controllers
{

public class ValuesController : ApiController
{
    /// <summary>
    /// Gets some very important data from the server.
    /// </summary>
    public IEnumerable<string> Get()
    {
        return new string[] { "value1", "value2" };
    }

    /// <summary>
    /// Looks up some data by ID.
    /// </summary>
    /// <param name="id">The ID of the data.</param>
    public string Get(int id)
    {
        return "value";
    }
}
}

第 2 步：将此代码添加到 route.config（如果您从头开始创建 api 项目，它会自动创建）因此，教程中未提及。

routes.MapHttpRoute(
        name: "DefaultApi",
        routeTemplate: "api/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional }
        );

当我运行程序运行时。 :)

ASP.NET web.api 帮助页面没有显示任何描述

ASP.NET web.api Help Page does not show any description

c#

asp.net

asp.net-mvc

asp.net-web-api-helppages