详解如何在ASP.NET Core Web API中以三种方式返回数据

站长资源 2024/11/30 佚名

2 0 1

在 ASP.NET Core 中有三种返回数据和 HTTP状态码的方式，最简单的就是直接返回指定的类型实例，如下代码所示：

  [ApiController]
  [Route("[controller]")]
  public class WeatherForecastController : ControllerBase
  {
    [HttpGet]
    public IEnumerable<WeatherForecast> Get()
    {
      var rng = new Random();
      return Enumerable.Range(1, 5).Select(index => new WeatherForecast
      {
        Date = DateTime.Now.AddDays(index),
        TemperatureC = rng.Next(-20, 55),
        Summary = Summaries[rng.Next(Summaries.Length)]
      })
      .ToArray();
    }
  }

除了这种，也可以返回 IActionResult 实例和 ActionResult <T> 实例。

虽然返回指定的类型是最简单粗暴的，但它只能返回数据，附带不了http状态码，而 IActionResult 实例可以将数据 + Http状态码一同带给前端，最后就是 ActionResult<T> 它封装了前面两者，可以实现两种模式的自由切换，"htmlcode">

  public class Author
  {
    public int Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
  }

有了这个 Author 类，接下来创建一个 DefaultController 类。

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;

namespace IDGCoreWebAPI.Controllers
{
  [Route("api/[controller]")]
  [ApiController]
  public class DefaultController : ControllerBase
  {
    private readonly List<Author> authors = new List<Author>();
    public DefaultController()
    {
      authors.Add(new Author()
      {
        Id = 1,
        FirstName = "Joydip",
        LastName = "Kanjilal"
      });
      authors.Add(new Author()
      {
        Id = 2,
        FirstName = "Steve",
        LastName = "Smith"
      });
    }

    [HttpGet]
    public IEnumerable<Author> Get()
    {
      return authors;
    }

    [HttpGet("{id}", Name = "Get")]
    public Author Get(int id)
    {
      return authors.Find(x => x.Id == id);
    }
  }
}

在 Action 中返回指定类型

最简单的方式就是在 Action 中直接返回一个简单类型或者复杂类型，其实在上面的代码清单中，可以看到 Get 方法返回了一个 authors 集合，看清楚了，这个方法定义的是 IEnumerable<Author>。

[HttpGet]
public IEnumerable<Author> Get()
{
  return authors;
}

在 ASP.NET Core 3.0 开始，你不仅可以定义同步形式的 IEnumerable<Author>方法，也可以定义异步形式的 IAsyncEnumerable<T>方法，后者的不同点在于它是一个异步模式的集合，好处就是不阻塞当前的调用线程，关于 IAsyncEnumerable<T> 更多的知识，我会在后面的文章中和大家分享。

下面的代码展示了如何用异步集合来改造 Get 方法。

[HttpGet]
public async IAsyncEnumerable<Author> Get()
{
  var authors = await GetAuthors();
  await foreach (var author in authors)
  {
    yield return author;
  }
}

在 Action 中返回 IActionResult 实例

如果你要返回 data + httpcode 的双重需求，那么 IActionResult 就是你要找的东西，下面的代码片段展示了如何去实现。

[HttpGet]
public IActionResult Get()
{
 if (authors == null)
   return NotFound("No records");

 return Ok(authors);
}

上面的代码有 Ok，NotFound 两个方法，对应着 OKResult，NotFoundResult， Http Code 对应着 200，404。当然还有其他的如：CreatedResult, NoContentResult, BadRequestResult, UnauthorizedResult, 和 UnsupportedMediaTypeResult，都是 IActionResult 的子类。

在 Action 中返回 ActionResult<T> 实例

ActionResult<T> 是在 ASP.NET Core 2.1 中被引入的，它的作用就是包装了前面这种模式，怎么理解呢？就是即可以返回 IActionResult ，也可以返回指定类型，从 ActionResult<TValue> 类下的两个构造函数中就可以看的出来。

public sealed class ActionResult<TValue> : IConvertToActionResult
{
  public ActionResult Result {get;}

  public TValue Value {get;}

  public ActionResult(TValue value)
  {
    if (typeof(IActionResult).IsAssignableFrom(typeof(TValue)))
    {
      throw new ArgumentException(Resources.FormatInvalidTypeTForActionResultOfT(typeof(TValue), "ActionResult<T>"));
    }
    Value = value;
  }

  public ActionResult(ActionResult result)
  {
    if (typeof(IActionResult).IsAssignableFrom(typeof(TValue)))
    {
      throw new ArgumentException(Resources.FormatInvalidTypeTForActionResultOfT(typeof(TValue), "ActionResult<T>"));
    }
    Result = (result "result"));
  }
}

有了这个基础，接下来看看如何在 Action 方法中去接这两种类型。

[HttpGet]
public ActionResult<IEnumerable<Author Get()
{
 if (authors == null)
    return NotFound("No records");
  return authors;
}

和文章之前的 Get 方法相比，这里直接返回 authors 而不需要再用 OK(authors) 包装，是不是一个非常好的简化呢？接下来再把 Get 方法异步化，首先考虑下面返回 authors 集合的异步方法。

private async Task<List<Author GetAuthors()
{
  await Task.Delay(100).ConfigureAwait(false);
  return authors;
}

值得注意的是，异步方法必须要有至少一个 await 语句，如果不这样做的话，编译器会提示一个警告错误，告知你这个方法将会被同步执行，为了避免出现这种尴尬，我在 Task.Delay 上做了一个 await。

下面就是更新后的 Get 方法，注意一下这里我用了 await 去调用刚才创建的异步方法，代码参考如下。

[HttpGet]
public async Task<ActionResult<IEnumerable<Author> Get()
{
  var data = await GetAuthors();
  if (data == null)
    return NotFound("No record");
  return data;
}

如果你有一些定制化需求，可以实现一个自定义的 ActionResult 类，做法就是实现 IActionResult 中的 ExecuteResultAsync 方法即可。

译文链接：https://www.infoworld.com/article/3520770/how-to-return-data-from-aspnet-core-web-api.html

ASP.NET,Core,Web,API返回数据,ASP.NET,Core,WebAPI

广告合作：本站广告合作请联系QQ：858582 申请时备注：广告合作（否则不回）
免责声明：本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除！

评论“详解如何在ASP.NET Core Web API中以三种方式返回数据”

暂无评论...

www.wwsws.com 伏龙阁资源网

39,976影音资源

44,792技术资源

21,817软件资源

651,128站长资源

详解如何在ASP.NET Core Web API中以三种方式返回数据

在 Action 中返回指定类型

在 Action 中返回 IActionResult 实例

在 Action 中返回 ActionResult<T> 实例

.NET 操作 PostgreSQL遇到的问题

详解如何在ASP.NET Core中使用Route特性

评论“详解如何在ASP.NET Core Web API中以三种方式返回数据”

RTX 5090要首发性能要翻倍！三星展示GDDR7显存

更新日志

友情链接

详解如何在ASP.NET Core Web API中以三种方式返回数据

在 Action 中返回 指定类型

在 Action 中返回 IActionResult 实例

在 Action 中返回 ActionResult<T> 实例

.NET 操作 PostgreSQL遇到的问题

详解如何在ASP.NET Core中使用Route特性

评论“详解如何在ASP.NET Core Web API中以三种方式返回数据”

RTX 5090要首发 性能要翻倍！三星展示GDDR7显存

更新日志

友情链接

在 Action 中返回指定类型

RTX 5090要首发性能要翻倍！三星展示GDDR7显存