当前位置：首页 > news >正文

.Net HttpClient 使用请求数据

news 来源：原创 2025/7/27 15:53:58

HttpClient 使用请求数据

0、初始化及全局设置

//初始化：必须先执行一次
#!import ./ini.ipynb

1、使用url 传参

参数放在Url里，形如：http://www.baidu.com?name=zhangsan&age=18, GET、Head请求用的比较多。优点是简单、方便，能被浏览器缓存；缺点是参数长度等限制较多，数据暴露url中，可能比较长。

/**URL传参：适合简单数据类型
*/
{//获取响应字符串{var response = await SharedClient.GetAsync("api/Normal/GetAccount?id=1");response.EnsureSuccessStatusCode();var content = await response.Content.ReadAsStringAsync();Console.WriteLine(content);}//获取响应对象{var response = await SharedClient.GetAsync("api/Normal/GetAccount?id=1");response.EnsureSuccessStatusCode();var result = await response.Content.ReadFromJsonAsync<BaseResult<Account>>();result.Display();}//直接获取响应对象{var result = await SharedClient.GetFromJsonAsync<BaseResult<Account>>("api/Normal/GetAccount?id=1");result.Display();}}

2、使用路由传参

路由参数，指参数使为URL的一部分，一般由后端API设定好，前端按规定使用即可。例如：后端指定/user/:id，前端使用/user/1，此时id为路由参数。

/*
** 路由参数：参数是URL的一部分,由后端指定
*/
{//大括号：方便折叠、开成单独的作用域var response = await SharedClient.GetAsync("api/Normal/GetAccount/管理员01");//确定是成功的响应response.EnsureSuccessStatusCode();//获取响应内容var content = await response.Content.ReadAsStringAsync();//输出 Console.WriteLine(content);
}

3、使用请求头

把请求数据放入请求头中，传给后端。当然也可以传多个数据。不过，请求头中传数据限制比较多，一般只传简单的数据：比如jwt token 。

/*
* 请求头: 值必须是字符串，如果有中文等需进行编码
*/
{//设置请求头//中文先编码，服务端接收后要解码var codedName = System.Net.WebUtility.UrlEncode("管理员01");//SharedClient是共用的，所以不能多次添加,先移除旧值if (SharedClient.DefaultRequestHeaders.Contains("name")){SharedClient.DefaultRequestHeaders.Remove("name");}//添加请求头SharedClient.DefaultRequestHeaders.Add("name", codedName);var response = await SharedClient.GetAsync("api/Normal/GetAccountFromHeader");//确定是成功的响应response.EnsureSuccessStatusCode();//获取响应内容var content = await response.Content.ReadAsStringAsync();//输出 Console.WriteLine(content);
}

4、使用请求体

把数据放在请求体中，发送到服务端。可以是简单的字符串，也可以是二进制数据(上传文件)、form表单项、编码过的form表单项、json、流式数据等形式，甚至是这个类型的组合。

说下个人的几点理解：
1、不管哪种请求体数据，都是放在请求体中，以二进制形式通过网络发往服务器，由服务器接收使用。客户端发送请求数据需要与服务端接收相配合；
2、客户端通过Content-Typey请求头设置，告诉服务端请求发送的是哪种类型的数据;服务端根据Content-Type来识别、解析请求数据。常见的类型有：multipart/form-data、application/x-www-form-urlencoded、application/json、text/plain等；
3、ASP.NET Core中，默认的请求体类型是FormUrlEncodedContent，所以默认情况下，客户端发送的请求数据是form表单项; asp.net 框架对json格式数据和表单数据进行了特殊处理，支持参数绑定等，可以使用[FromBody]特性，将请求数据绑定到对应的模型上。但普通的文本类型等不支持绑定等功能，需要从请求体中获取原始数据，自行处理。
4、一次可发送多种格式数据，由统一的分隔符分隔。服务端可以从请求头[] Content-Type: multipart/mixed; boundary=“d2e38916-df08-4fec-a40e-3e5179736f32”]拿到分隔符，然后根据分隔符将数据拆分出来。

HttpClient 中，请求体也分为这几种(常见的)类型：

MultipartFormDataContent
FormUrlEncodedContent
JsonContent
StringContent
ByteArrayContent
StreamContent
MultipartContent

MultipartFormDataContent ：Form表单

Form表单，提交数据方式之一。

/*
*   Form表单，提交数据。一般为Put或Post提交。
*/
{// 创建一个 MultipartFormDataContent 对象, 用来存入 Form表单 各项及值var formContent = new MultipartFormDataContent();// 添加表单字段formContent.Add(new StringContent("1"), "id");formContent.Add(new StringContent("管理员01"), "name");// 发送POST请求var response = await SharedClient.PostAsync("api/AdvancedGet/PostFormData", formContent);// 读取响应内容string responseString = await response.Content.ReadAsStringAsync();Console.WriteLine(responseString);
}

FormUrlEncodedContent ：Form表单 asp.net core 默认接收方式

/*FormUrlEncoded 提交数据 
*/
{//设置数据项var urlEncodedData = new List<KeyValuePair<string,string>>(){new KeyValuePair<string,string>(key:"id",value:"1"),new KeyValuePair<string,string>(key:"name",value:"管理员01"),};//FormUrlEncodedContent对象var formContent = new FormUrlEncodedContent(urlEncodedData);// 发送POST请求var response = await SharedClient.PostAsync("api/AdvancedGet/PostFormData", formContent);// 读取响应内容string responseString = await response.Content.ReadAsStringAsync();Console.WriteLine(responseString);
}

StringContent 普通文本(也包括很多格式，甚至是自定义格式。要和服务器配合)

/*普通文本方式提交数据
*/
{var requestContent = new StringContent("我是请求体第一段内容", Encoding.UTF8, "text/plain");var response = await SharedClient.PostAsync("/api/AdvancedPost/TextData", requestContent);var content = await response.Content.ReadAsStringAsync();Console.WriteLine(content);
}