ASP.NET Core MVC/WebApi基础系列1

本攻略将介绍ASP.NET Core MVC/WebApi的基础知识，包括控制器、路由、模型绑定、过滤器等。本攻略将提供详细的步骤和示例说明，以帮助您快速入门ASP.NET Core MVC/WebApi。

步骤

步骤1：创建一个新的ASP.NET Core MVC/WebApi项目

首先，需要创建一个新的ASP.NET Core MVC/WebApi项目。可以使用以下命令在命令行中创建新的ASP.NET Core MVC/WebApi项目：

dotnet new webapi -n MyWebApi

在上面的命令中，使用 dotnet new 命令创建一个新的ASP.NET Core MVC/WebApi项目。使用 -n 参数指定项目的名称为 MyWebApi。

步骤2：创建一个控制器

接下来，需要创建一个控制器。可以在项目中创建一个名为 ValuesController.cs 的文件，并添加以下代码：

using Microsoft.AspNetCore.Mvc;

namespace MyWebApi.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class ValuesController : ControllerBase
    {
        [HttpGet]
        public ActionResult<string[]> Get()
        {
            return new string[] { "value1", "value2" };
        }
    }
}

在上面的代码中，我们创建了一个名为 ValuesController 的控制器，并使用 [ApiController] 和 [Route] 属性来定义路由。我们还定义了一个名为 Get 的方法，该方法返回一个字符串数组。

步骤3：启动应用程序

现在，可以启动应用程序。可以使用以下命令在命令行中启动应用程序：

dotnet run

在上面的命令中，使用 dotnet run 命令启动应用程序。

步骤4：测试应用程序

现在，可以测试应用程序。可以使用浏览器或任何HTTP客户端工具（如Postman）访问以下URL：

https://localhost:5001/values

在上面的URL中，我们使用控制器的路由来访问 ValuesController 的 Get 方法。如果一切正常，应该会看到以下JSON响应：

["value1","value2"]

示例说明

以下是两个示例说明，演示如何在ASP.NET Core MVC/WebApi中使用控制器、路由、模型绑定和过滤器。

示例1：使用模型绑定

以下是使用模型绑定的步骤：

1. 创建一个新的ASP.NET Core MVC/WebApi项目。

dotnet new webapi -n MyWebApi

在上面的命令中，使用 dotnet new 命令创建一个新的ASP.NET Core MVC/WebApi项目。使用 -n 参数指定项目的名称为 MyWebApi。

1. 创建一个控制器。

在项目中创建一个名为 ValuesController.cs 的文件，并添加以下代码：

using Microsoft.AspNetCore.Mvc;

namespace MyWebApi.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class ValuesController : ControllerBase
    {
        [HttpGet("{id}")]
        public ActionResult<string> Get(int id)
        {
            return $"value {id}";
        }
    }
}

在上面的代码中，我们创建了一个名为 ValuesController 的控制器，并使用 [ApiController] 和 [Route] 属性来定义路由。我们还定义了一个名为 Get 的方法，该方法使用模型绑定来获取 id 参数，并返回一个字符串。

1. 启动应用程序。

使用以下命令在命令行中启动应用程序：

dotnet run

在上面的命令中，使用 dotnet run 命令启动应用程序。

1. 测试应用程序。

使用浏览器或任何HTTP客户端工具（如Postman）访问以下URL：

https://localhost:5001/values/1

在上面的URL中，我们使用控制器的路由来访问 ValuesController 的 Get 方法，并将 id 参数设置为 1。如果一切正常，应该会看到以下JSON响应：

"value 1"

示例2：使用过滤器

以下是使用过滤器的步骤：

1. 创建一个新的ASP.NET Core MVC/WebApi项目。

dotnet new webapi -n MyWebApi

在上面的命令中，使用 dotnet new 命令创建一个新的ASP.NET Core MVC/WebApi项目。使用 -n 参数指定项目的名称为 MyWebApi。

1. 创建一个过滤器。

在项目中创建一个名为 MyFilter.cs 的文件，并添加以下代码：

using Microsoft.AspNetCore.Mvc.Filters;
using Microsoft.Extensions.Logging;

public class MyFilter : IActionFilter
{
    private readonly ILogger<MyFilter> _logger;

    public MyFilter(ILogger<MyFilter> logger)
    {
        _logger = logger;
    }

    public void OnActionExecuting(ActionExecutingContext context)
    {
        _logger.LogInformation("Action is executing.");
    }

    public void OnActionExecuted(ActionExecutedContext context)
    {
        _logger.LogInformation("Action is executed.");
    }
}

在上面的代码中，我们创建了一个名为 MyFilter 的过滤器，并实现了 IActionFilter 接口。我们在 OnActionExecuting 和 OnActionExecuted 方法中添加了日志记录。

1. 注册过滤器。

在 Startup.cs 文件中，添加以下代码：

services.AddControllers(options =>
{
    options.Filters.Add(typeof(MyFilter));
});

在上面的代码中，我们在 AddControllers 方法中注册了 MyFilter 过滤器。

1. 创建一个控制器。

在项目中创建一个名为 ValuesController.cs 的文件，并添加以下代码：

using Microsoft.AspNetCore.Mvc;

namespace MyWebApi.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class ValuesController : ControllerBase
    {
        [HttpGet("{id}")]
        public ActionResult<string> Get(int id)
        {
            return $"value {id}";
        }
    }
}

在上面的代码中，我们创建了一个名为 ValuesController 的控制器，并使用 [ApiController] 和 [Route] 属性来定义路由。我们还定义了一个名为 Get 的方法，该方法使用模型绑定来获取 id 参数，并返回一个字符串。

1. 启动应用程序。

使用以下命令在命令行中启动应用程序：

dotnet run

在上面的命令中，使用 dotnet run 命令启动应用程序。

1. 测试应用程序。

使用浏览器或任何HTTP客户端工具（如Postman）访问以下URL：

https://localhost:5001/values/1

在上面的URL中，我们使用控制器的路由来访问 ValuesController 的 Get 方法，并将 id 参数设置为 1。如果一切正常，应该会看到以下JSON响应：

"value 1"

在控制台中，应该会看到以下日志记录：

info: MyWebApi.MyFilter[0]
      Action is executing.
info: MyWebApi.MyFilter[0]
      Action is executed.

结论

本攻略提供了ASP.NET Core MVC/WebApi的基础知识，包括控制器、路由、模型绑定、过滤器等。我们提供了详细的步骤和示例说明，以帮助您快速入门ASP.NET Core MVC/WebApi。