ASP.NET中Web API的參數(shù)綁定
在這篇文章中，我們將學(xué)習(xí)WebAPI如何將HTTP請求數(shù)據(jù)綁定到一個操作方法的參數(shù)中。
操作方法在WebAPI控制器中可以有一個或多個不同類型的參數(shù)。它可以是基本數(shù)據(jù)類型或復(fù)雜類型。WebAPI根據(jù)URL的查詢字符串或請求主體中參數(shù)類型來綁定操作方法的參數(shù)。
如果參數(shù)類型是基本數(shù)據(jù)類型（int，double，string，DateTime，bool等），WebAPI默認(rèn)將會從URL中獲取參數(shù)值（即通過querystring）獲取。
如果參數(shù)類型的復(fù)雜類型，WebAPI默認(rèn)從請求主體中獲取參數(shù)值。
下表列出了Web API參數(shù)綁定的默認(rèn)規(guī)則。
| HTTP方法 | Query String | Request Body |
|---|---|---|
| GET | 簡單類型 | 不能從請求主體中獲取參數(shù)值 |
| POST | 簡單類型 | 復(fù)雜類型 |
| PUT | 簡單類型 | 復(fù)雜類型 |
| PATCH | 簡單類型 | 復(fù)雜類型 |
| DELETE | 簡單類型 | 不能從請求主體中獲取參數(shù)值 |
我們先來看看創(chuàng)建帶MVC的Web API項目時自動生成的Values控制器是如何定義的。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
namespace WebAPIContainMVC.Controllers
{
public class ValuesController : ApiController
{
// GET api/values
public IEnumerable<string> Get()
{
return new string[] { "value1", "value2" };
}
// GET api/values/5
public string Get(int id)
{
return "value";
}
// POST api/values
public void Post([FromBody]string value)
{
}
// PUT api/values/5
public void Put(int id, [FromBody]string value)
{
}
// DELETE api/values/5
public void Delete(int id)
{
}
}
}從Values控制器的定義中，我們可以得出如下幾個結(jié)論：
（1）WebAPI常規(guī)的方法有四個：Get()，Post()，Put()和Delete()。
（2）四種方法的參數(shù)可以歸納為兩大類：URL傳遞（Request-url）和Body（Request-body）傳遞。
（3）可以將四種方法的參數(shù)傳遞歸為兩大類，而這兩大類又集中在Get和Post中體現(xiàn)（Put是Get和Post的組合，Delete和Get類型），所以說研究WebAPI的參數(shù)綁定，只需要研究Get和Post方法的參數(shù)傳遞即可，Get對應(yīng)Request-url，Post對應(yīng)Request-Body。
在本篇文章中，客戶端調(diào)用使用Fiddler工具進行測試。
一、Get
1、基本數(shù)據(jù)類型作為方法參數(shù)
1.1方法只含有一個參數(shù)（形參可以傳遞進來）
方法定義如下：
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
using WebAPIContainMVC.Entity;
namespace WebAPIContainMVC.Controllers
{
public class StudentController : ApiController
{
[HttpGet]
public string GetStudentById(int id)
{
string strResult=string.Empty;
List<Student> list = new List<Student>();
Student stu = new Student()
{
StudentId=1,
Name="Tom",
Age=20,
Sex="男"
};
list.Add(stu);
list.ForEach(p =>
{
if (p.StudentId.Equals(id))
{
strResult = "存在該學(xué)生信息";
}
else
{
strResult = "對不起，找不到該學(xué)生信息";
}
});
return strResult;
}
}
}客戶端調(diào)用
結(jié)果：
雙擊左側(cè)的進程，得到如下的結(jié)果
1.2、方法含有多個參數(shù)（形參可以傳遞進來）
方法定義如下：
public string GetStudentByIdAndName(int id,string name)
{
string strResult = string.Empty;
List<Student> list = new List<Student>();
Student stu = new Student()
{
StudentId = 1,
Name = "Tom",
Age = 20,
Sex = "男"
};
list.Add(stu);
list.ForEach(p =>
{
if (p.StudentId.Equals(id)&&p.Name.Equals(name))
{
strResult = "存在該學(xué)生信息";
}
else
{
strResult = "對不起，找不到該學(xué)生信息";
}
});
return strResult;
}URL地址：http://localhost:63512/api/student?id=1&&name=Tom
結(jié)果如下：
2、實體對象類型作為方法參數(shù)（形參不能傳遞進來）
方法定義如下：
[HttpGet]
public string GetStudent(Student student)
{
string strResult = string.Empty;
List<Student> list = new List<Student>();
Student stu = new Student()
{
StudentId = 1,
Name = "Tom",
Age = 20,
Sex = "男"
};
list.Add(stu);
if (student != null)
{
list.ForEach(p =>
{
if (p.StudentId.Equals(student.StudentId))
{
strResult = "存在該學(xué)生信息";
}
else
{
strResult = "對不起，找不到該學(xué)生信息";
}
});
}
else
{
strResult = "參數(shù)值為Null";
}
return strResult;
}客戶端調(diào)用結(jié)果如下：
3、基本數(shù)據(jù)類型和實體對象混合作為方法參數(shù)（基本數(shù)據(jù)類型可以傳遞進來，實體對象不能傳遞進來）
4、總結(jié)
（1）查詢字符串參數(shù)名稱和操作方法參數(shù)名稱必須相同（不區(qū)分大小寫）。參數(shù)的先后順序可以不一致。
（2）Get()參數(shù)傳遞的本質(zhì)是URL字符串拼接，但是URL字符串的長度受限制。
（3）Get()的參數(shù)支持基本數(shù)據(jù)類型，不支持實體數(shù)據(jù)類型。
（4）Get()參數(shù)的傳遞是在Http請求的頭部傳遞，而不支持Request-Body傳遞。
（5）Get類型的方法命名，盡量采用“Get+方法名”的命名方式，在方法前面加上特性：[HttpGet]。
二、Post
1、Post參數(shù)傳遞是在Request-Body內(nèi)傳遞。
2、Post參數(shù)可以傳遞基本數(shù)據(jù)類型，也可以傳遞實體數(shù)據(jù)類型。
3、Post操作方法只能包含一個實體數(shù)據(jù)類型，因為只能允許一個參數(shù)讀取Request-Body中的數(shù)據(jù)。
4、Post傳遞參數(shù)時，無論是基本類型參數(shù)還是實體類型，均需要借助[FromBody]特性。（有些情況下不寫[FromBody]特性也可以把參數(shù)傳遞進來，但為了規(guī)范化，最好是加上該特性）。
5、Post類型的方法命名，盡量采用“Post+方法名”的命名方式，在方法前面加上特性：[HttpPost]。
三、FromURI與FromBody
在默認(rèn)情況下，WebAPI是從查詢字符串中得到基本數(shù)據(jù)類型參數(shù)的值，從請求主體中得到復(fù)雜類型參數(shù)的值，如果想改變這種默認(rèn)情況怎么辦？
可以使用[FromURI]屬性，是WebAPI從查詢字符串中獲取復(fù)雜類型參數(shù)的值，使用[FromBody]屬性可以使WebAPI從請求主體中獲取基本數(shù)據(jù)類型參數(shù)的值。
例如下面的Get方法
[HttpGet]
public string GetStudentById([FromUri]Student stu)
{
}Get方法中包括復(fù)雜的類型參數(shù)，參數(shù)添加了[FromUri]屬性，WebAPI將試圖從查詢字符串中得到Student類型參數(shù)的值。
同樣，參考下面的Post方法：
[HttpPost]
public string Post([FromBody]string name)
{ }WebAPI將從請求主體中獲取基本類型參數(shù)的值，而不是從請求字符串中獲取。
到此這篇關(guān)于ASP.NET中Web API參數(shù)綁定的文章就介紹到這了。希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
這篇文章介紹了Asp.Net用OWC操作Excel的實例代碼，有需要的朋友可以參考一下，希望對你有所幫助2013-07-07
這篇文章介紹了Asp.net Core項目配置HTTPS支持的方法，文中通過示例代碼介紹的非常詳細(xì)。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-09-09
這篇文章主要介紹了詳解EFCore中的導(dǎo)航屬性的相關(guān)資料，幫助大家更好的理解和學(xué)習(xí)使用ASP.NET CORE，感興趣的朋友可以了解下2021-03-03
.net core使用FastHttpApi構(gòu)建web聊天室實例代碼
這篇文章主要給大家介紹了關(guān)于.net core使用FastHttpApi構(gòu)建web聊天室的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2018-10-10
學(xué)習(xí)使用ASP.NET 2.0的本地化...2007-04-04
ajax.net對數(shù)據(jù)庫的插入實例，需要的朋友可以參考一下2013-04-04
這篇文章介紹了.Net實現(xiàn)合并文件的具體方法，有需要的朋友可以參考一下2013-07-07
.NET Core實現(xiàn)分表分庫、讀寫分離的通用 Repository功能
這篇文章主要介紹了.NETCore 下支持分表分庫、讀寫分離的通用 Repository，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-04-04
Visual Stduio 2010開發(fā)環(huán)境搭建教程
這篇文章主要為大家詳細(xì)介紹了Visual Stduio 2010開發(fā)環(huán)境搭建教程，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-04-04
項目中用到的小技巧2010-03-03