.Net Core 5下WebAPI FromForm 及FromBody FromQuery使用方式，有图有真相

最新推荐文章于 2025-04-18 08:38:03 发布

代码工艺师

最新推荐文章于 2025-04-18 08:38:03 发布

阅读量6.7k

点赞数

分类专栏： .NET 文章标签： .netcore microsoft

本文链接：https://blog.csdn.net/hamunet/article/details/120968882

版权

.NET 专栏收录该内容

11 篇文章

订阅专栏

本文详细介绍了ASP.NET Core后端接口如何处理来自前端的POST请求，包括FromForm、FromBody和FromQuery三种方式。针对每种方式，提供了相应的后端代码示例和JS请求示例，并分析了不同Content-Type对数据传递的影响。同时，讨论了对象参数和单独参数的接收规则及其适用场景。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

FromForm POST方式

后端代码

       [HttpPost("Tel/FromFormTest")]
        public async Task<ActionResult<ResponseMessageWrap<string>>> FromFormTest([FromForm] TelOutPos telOutPos)
        {
             await Task.CompletedTask;
            return new ResponseMessageWrap<string> {Data= telOutPos.agNo };
        }

Js请求：

1、 Content-Type：application/x-www-form-urlencoded
var settings = {
  "url": "http://localhost:5003/Tel/FromFormTest",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/x-www-form-urlencoded"
  },
  "data": {
    "regId": "123131",
    "token": "123123",
    "agNo": "123213",
    "bindTel": "2222"
  }
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

2、 Content-Type：multipart/form-data
var form = new FormData();
form.append("regId", "11");
form.append("token", "22");

var settings = {
  "url": "http://localhost:5003/Tel/FromFormTest",
  "method": "POST",
  "timeout": 0,
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

3、Content-Type：application/json 对象值传不过去

总结:
1、接口参数为对象:只能key value方式对象传递，后台可以接收到，符合以上3中方式
2、接口参数分别接受，url方式传值不考虑Content-Type 类型都可以接受到的
...FromFormTest1?regId=13&token=1213&agNo=123213&bindTel=123123

后台代码 Dictionary 为key value 集合

        public static async Task<(bool, string)> HttpPostAsyncOptimizeFormUrl(string requestUrl, Dictionary<string, string> dicUrl)
        {
            try
            {
                using (HttpClient httpClient = new HttpClient())
                {
                    StringBuilder builder = new StringBuilder();
                    int i = 0;
                    foreach (var item in dicUrl)
                    {
                        if (i > 0)
                            builder.Append("&");
                        builder.AppendFormat("{0}={1}", item.Key, item.Value);
                        i++;
                    }
                    var responseResult = httpClient.PostAsync(requestUrl, new StringContent(builder.ToString(), System.Text.Encoding.UTF8, "application/x-www-form-urlencoded")).Result;
                    if (responseResult.StatusCode == HttpStatusCode.OK)
                    {
                        return (true, await responseResult.Content.ReadAsStringAsync());
                    }
                    else
                    {
                        return (false, $"接口地址返回错误状态码:{responseResult.StatusCode}");
                    }

                }
            }

FromBody POST方式
后台代码：

       [HttpPost("Tel/FromBodyTest")]
        public async Task<ActionResult<ResponseMessageWrap<string>>> FromBodyTest([FromBody] TelOutPos telOutPoso)
        {
            await Task.CompletedTask;
            return new ResponseMessageWrap<string> { Data = telOutPoso.agNo };
        }

Js：

var settings = {
  "url": "http://localhost:5003/Tel/FromBodyTest",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({
    "agNo": "1123"
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

只能才作用 "Content-Type": "application/json" 这种方式，其他方式一律报media type 错误

FromQuery
接口参数对象可以接受URL传值，不接受对象传值,GET方式比较符合这种场景，POST当然也可以
FromQueryTest?egId=13&token=1213&agNo=123213&bindTel=123123
后台代码：

       [HttpPost("Tel/FromQueryTest")]
        public async Task<ActionResult<ResponseMessageWrap<string>>> FromQueryTest([FromQuery] TelOutPos telOutPos)
        {
            await Task.CompletedTask;
            return new ResponseMessageWrap<string> { Data = telOutPos.agNo };
        }