如何将Web API添加到现有的ASP.NET MVC(5)Web应用程序项目中?


146

假设在创建新的MVC(5)项目时忘记了选中Web API复选框(将其添加到项目中),那么您需要做些什么来添加Web API并使它正常工作?

有很多迁移问题,但是似乎没有一个完整的最新步骤可将Web API添加到MVC 5项目中,并且它似乎已经从一些旧的答案中改变了。

将Web API添加到MVC 4

添加GlobalConfiguration.Configure(WebApiConfig.Register)MVC 4

Answers:


253

更新MVC项目

使用Nuget获取最新的Web API。

项目-右键单击-管理Nuget包-搜索Web API(Microsoft ASP.NET Web API ...)并将其安装到您的MVC项目。

然后,您仍然需要使Web API路由起作用。来自Microsoft的配置ASP.NET Web API 2

将WebApiConfig.cs添加到App_Start /文件夹

using System.Web.Http;

namespace WebApplication1
{
    public static class WebApiConfig
    {
        public static void Register(HttpConfiguration config)
        {
            // TODO: Add any additional configuration code.

            // Web API routes
            config.MapHttpAttributeRoutes();

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

        // WebAPI when dealing with JSON & JavaScript!
        // Setup json serialization to serialize classes to camel (std. Json format)
        var formatter = GlobalConfiguration.Configuration.Formatters.JsonFormatter;
        formatter.SerializerSettings.ContractResolver =
            new Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver();
        }
    }
}

如果您有一个MVC项目,它将具有Global.asax.cs,添加新路径。Global.asax.cs路由的顺序至关重要。请注意,有一些过时的示例使用 WebApiConfig.Register

将此行添加到Global.asax.cs: GlobalConfiguration.Configure(WebApiConfig.Register);

protected void Application_Start()
{
    // Default stuff
    AreaRegistration.RegisterAllAreas();

    // Manually installed WebAPI 2.2 after making an MVC project.
    GlobalConfiguration.Configure(WebApiConfig.Register); // NEW way
    //WebApiConfig.Register(GlobalConfiguration.Configuration); // DEPRECATED

    // Default stuff
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
    RouteConfig.RegisterRoutes(RouteTable.Routes);
    BundleConfig.RegisterBundles(BundleTable.Bundles);
}

WebAPI帮助

为了得到(非常有用的WebAPI帮助页面,安装WebAPI.HelpPage。请参阅http://channel9.msdn.com/Events/Build/2014/3-644(约42分钟)以了解其功能。看起来很有帮助!

Nuget控制台: Install-Package Microsoft.AspNet.WebApi.HelpPage

要验证WebAPI是否正常运行:

到controllers文件夹-> Add new item-> Web API Controller Class。

public class TestController : ApiController
{
    //public TestController() { }

    // GET api/<controller>
    public IEnumerable<string> Get()
    {
        return new string[] { "value1", "value2" };
    }

    // GET api/<controller>/5
    public string Get(int id)
    {
        return "value";
    }
    //...
}

现在,您可以像往常一样在IE / FF / Chrome中进行测试,或者在JavaScript控制台中进行非获取测试。

(仅使用URL中的控制器,它将在新的Web API控制器中调用GET()操作,它会根据REST自动映射到方法/操作,例如PUT / POST / GET / DELETE。您无需调用通过像在MVC中一样进行操作)直接通过URL:

http://localhost:PORT/api/CONTROLLERNAME/

或者使用jQuery查询控制器。运行项目,打开控制台(在IE中为F12),然后尝试运行Ajax查询。(检查您的端口和控制器名称)

$.get( "http://localhost:PORT/api/CONTROLLERNAME/", function( data ) {
    //$( ".result" ).html( data );
    alert( "Get data received:" + data);
});

旁注:在项目中结合使用MVC和Web API时,需要考虑一些利弊

WebAPI帮助验证: http://localhost:PORT/help


@Iko我已经完成了您在代码上编写的所有内容,但是运行它时出现了错误。它给了我一个错误
ninjaXnado 2014年

1
尝试搜索错误消息。这些步骤本质上是一般情况下所需的步骤。
lko 2015年

13
“ Global.asax.cs路由的顺序很关键” +1
Jim Aho

我不明白如何测试是否正确添加了Web API?我到底应该写什么到浏览器?我写了,http://localhost:12345/api/Get/5但出现错误。
杰森2015年

3
我正在使用“旧方法”调用WebApiConfig.Register(GlobalConfiguration.configuration); 而且我无法再调试。我将开始调试,它将永远无法达到我的控制器功能。我改为“新方法” GlobalConfiguration.Configure(WebApiConfig.Register); 并且问题得以解决。
D. Kermott,
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.