自承载 Self-Host ASP.NET Web API 1 (C#)

本教程介绍如何在控制台应用程序中托管 Web API。 ASP.NET Web API不需要 IIS。 可以在自己的主机进程中自托管 Web API。

创建控制台应用程序项目

启动 Visual Studio，然后从“开始”页中选择“新建项目”。 或者，从“ 文件 ”菜单中选择“ 新建 ”，然后选择“ 项目”。

在“ 模板 ”窗格中，选择“ 已安装的模板 ”，然后展开 “Visual C# ”节点。 在 “Visual C#”下，选择“ Windows”。 在项目模板列表中，选择“ 控制台应用程序”。 将项目命名为“SelfHost”，然后单击“ 确定”。

(Visual Studio 2010) 设置目标框架

如果使用 Visual Studio 2010，请将目标框架更改为 .NET Framework 4.0。 (默认情况下，项目模板以 .Net Framework 客户端配置文件为目标)

在“解决方案资源管理器”中，右键单击项目并选择“属性”。 在“目标框架”下拉列表中，将目标框架更改为 .NET Framework 4.0。 当系统提示应用更改时，单击“ 是”。

安装 NuGet 包管理器

NuGet 包管理器是将 Web API 程序集添加到 non-ASP.NET 项目的最简单方法。

若要检查是否安装了 NuGet 包管理器，请单击 Visual Studio 中的“工具”菜单。 如果看到名为 NuGet 包管理器的菜单项，则表示具有 NuGet 包管理器。

安装 NuGet 包管理器：

1. 启动 Visual Studio。
2. 在“工具”菜单上，选择“扩展和更新”。
3. 在“扩展和汇报”对话框中，选择“联机”。
4. 如果未看到“NuGet 包管理器”，请在搜索框中键入“nuget 包管理器”。
5. 选择 NuGet 包管理器，然后单击“ 下载”。
6. 下载完成后，系统会提示安装。
7. 安装完成后，系统可能会提示重启 Visual Studio。

添加 Web API NuGet 包

安装 NuGet 包管理器后，将 Web API Self-Host包添加到项目中。

从“ 工具 ”菜单中，选择“ NuGet 包管理器”。 注意：如果未看到此菜单项，请确保正确安装 NuGet 包管理器。

1. 选择“管理解决方案的 NuGet 包”
2. 在 “管理 NugGet 包 ”对话框中，选择“ 联机”。
3. 在搜索框中，键入“Microsoft.AspNet.WebApi.SelfHost”。
4. 选择 ASP.NET Web API自主机包，然后单击“安装”。
5. 安装包后，单击“ 关闭 ”关闭对话框。

备注：请确保安装名为 Microsoft.AspNet.WebApi.SelfHost 的包，而不是 AspNetWebApi.SelfHost。

创建模型和控制器

本教程使用与入门教程相同的模型和控制器类。

添加名为 Product的公共类。

namespace SelfHost
{
   
   
    public class Product
    {
   
   
        public int Id {
   
    get; set; }
        public string Name {
   
    get; set; }
        public string Category {
   
    get; set; }
        public decimal Price {
   
    get; set; }
    }
}

添加名为 ProductsController的公共类。 从 System.Web.Http.ApiController 派生此类。

namespace SelfHost
{
   
   
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Net;
    using System.Web.Http;
    
    public class ProductsController : ApiController
    {
   
   
        Product[] products = new Product[</