在本篇文章中將講解如何使用Visual Studio創(chuàng)建一個(gè)新的ASP.NET Web API項(xiàng)目。

在VisualStudio中有兩種方式用于創(chuàng)建WebAPI項(xiàng)目：

1、創(chuàng)建帶MVC的WebAPI項(xiàng)目。

2、創(chuàng)建獨(dú)立的WebAPI項(xiàng)目。

一、創(chuàng)建帶MVC的WebAPI項(xiàng)目

在示例程序中使用的是VisualStudio 2013版本，創(chuàng)建一個(gè)新的WebAPI項(xiàng)目并且?guī)VC的模板，它包含了所有必要的引用。

1、選擇“文件”->“新建”->“項(xiàng)目”，截圖如下所示：

2、在彈出的新建項(xiàng)目窗口中，左側(cè)模板選擇Visual C#->Web，中間面板選擇ASP.NET Web應(yīng)用程序，輸入項(xiàng)目名稱，點(diǎn)擊確定，界面如下：

3、在彈出的新建ASP.NET項(xiàng)目的窗口中，模板類型選擇Web API，會(huì)看到下面默認(rèn)勾選了MVC和Web API的復(fù)選框，這意味著它將添加MVC和WebAPI必要的文件夾和相關(guān)引用。點(diǎn)擊確定按鈕，界面截圖如下：

4、新建的WebAPI項(xiàng)目結(jié)構(gòu)如下圖所示

這個(gè)項(xiàng)目就是一個(gè)默認(rèn)的MVC項(xiàng)目加兩個(gè)為WebAPI準(zhǔn)備的特定文件：即App_Start文件夾中的WebApiConfig.cs和Controllers文件夾中的ValuesController.cs文件。

WebApiConfig.cs是WebAPI的配置文件，可以配置WebAPI路由和其他信息，跟MVC的RouteConfig.cs文件的作用相同。內(nèi)容如下圖所示：

ValuesController.cs是默認(rèn)創(chuàng)建的WebAPI的控制器，包括WebAPI中常用的幾個(gè)方法，內(nèi)容如下圖所示：

到此為止，已經(jīng)成功創(chuàng)建了一個(gè)帶MVC的WebAPI項(xiàng)目。

二、創(chuàng)建獨(dú)立的WebAPI項(xiàng)目

在上面講解了如何使用VisualStudio創(chuàng)建一個(gè)帶MVC的WebAPI項(xiàng)目，接下來(lái)將會(huì)講解如何創(chuàng)建一個(gè)獨(dú)立的WebAPI項(xiàng)目。

1、選擇“文件”->“新建”->“項(xiàng)目”，截圖如下所示：

2、在彈出的新建項(xiàng)目窗口中，左側(cè)模板選擇Visual C#->Web，中間面板選擇ASP.NET Web應(yīng)用程序，輸入項(xiàng)目名稱，點(diǎn)擊確定，界面如下：

3、在彈出的新建ASP.NET項(xiàng)目的窗口中，模板類型選擇Empty，點(diǎn)擊確定按鈕，界面截圖如下：

4、這時(shí)將創(chuàng)建一個(gè)空的WebAPI項(xiàng)目。項(xiàng)目結(jié)構(gòu)如下：

現(xiàn)在，我們需要使用NuGet包管理器添加最新的WebAPI引用。

5、右鍵單擊項(xiàng)目，然后單擊“管理NuGet程序包”，界面截圖如下：

6、打開管理NuGet程序包界面，在搜索框里輸入“WebAPI”，選擇Microsoft ASP.NET Web API2.2包并點(diǎn)擊安裝，界面如下所示：

7、出現(xiàn)如下圖所示的界面表示W(wǎng)ebAPI安裝成功

8、在項(xiàng)目中創(chuàng)建配置文件夾，并添加配置類，配置類定義如下：

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

namespace IndependentWebAPI.Configuration
{
    public static class WebApiConfig
    {
        public static void Register(HttpConfiguration config)
        {
            // Web API 配置和服務(wù)

            // Web API 路由
            config.MapHttpAttributeRoutes();

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

9、添加Global.asax文件。

右鍵點(diǎn)擊項(xiàng)目，選擇“添加”->“新建項(xiàng)”，界面截圖如下：

10、在添加新項(xiàng)界面，選擇web下面的“全局應(yīng)用程序類”，并命名為“Global.asax”，點(diǎn)擊添加按鈕，這樣就將Global.asax文件添加到了項(xiàng)目中。界面截圖如下所示：

11、配置應(yīng)用程序啟動(dòng)時(shí)的WebAPI的路由。

需要在Global.asax文件的Application_Start方法中調(diào)用WebApiConfig.Register()方法來(lái)配置WebAPI。Application_Start()方法定義如下：

protected void Application_Start(object sender, EventArgs e)
{
       GlobalConfiguration.Configure(WebApiConfig.Register);
}

配置Web API只需要使用基于代碼的配置GlobalConfiguration 類。因此,當(dāng)應(yīng)用程序啟動(dòng),它將調(diào)用Application_Start事件，進(jìn)而調(diào)用HelloWebAPIConfig.Register()方法來(lái)配置您的Web API。

12、添加控制器

在項(xiàng)目上右鍵添加Controller文件夾，然后在新添加的Controller文件夾上右鍵選擇“添加”->“控制器”，界面截圖如下：

13、在添加基架界面選擇WebAPI下面的WebAPI 2控制器 -空，點(diǎn)擊添加按鈕。截圖如下所示：

14、在添加控制器界面，輸入控制器的名稱（控制器以Controller結(jié)尾），并點(diǎn)擊添加按鈕。截圖如下所示：

15、為控制器類添加簡(jiǎn)單的GET方法，GET()方法定義如下：

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

namespace IndependentWebAPI.Controller
{
    public class HomeController : ApiController
    {
        [HttpGet]
        public string Get()
        {
            return "Hello World";
        }
    }
}

16、編譯并運(yùn)行項(xiàng)目，輸出結(jié)果如下圖所示：

這樣就創(chuàng)建了一個(gè)獨(dú)立的WebAPI項(xiàng)目。

到此這篇關(guān)于使用Visual Studio創(chuàng)建ASP.NET Web API項(xiàng)目的文章就介紹到這了。希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論