c#如何发送POST请求_c#发送POST请求完整教程与代码实例-C#.Net教程-PHP中文网

最稳妥的 post 请求应使用 httpclient：表单数据用 formurlencodedcontent 自动编码，json 用 system.text.json 序列化并设 utf-8 和 application/json，文件上传用 multipartformdatacontent 管理流生命周期；务必复用 httpclient 实例、设置超时、处理证书与异步上下文。

c#如何发送post请求_c#发送post请求完整教程与代码实例

直接用 HttpClient 发送 POST 请求最稳妥，别碰过时的 WebClient 或手动拼 HttpWebRequest —— 容易漏头、乱编码、不支持异步取消，且 .NET Core / .NET 5+ 已明确推荐 HttpClient 为唯一首选。

怎么发最简 POST（表单数据）

多数接口接收 application/x-www-form-urlencoded，比如登录、提交表单。别手拼字符串，用 FormUrlEncodedContent 自动处理编码和键值对：

var client = new HttpClient();
var data = new Dictionary<string string>
{
    { "username", "admin" },
    { "password", "123456" }
};
var content = new FormUrlEncodedContent(data);
var response = await client.PostAsync("https://api.example.com/login", content);
var body = await response.Content.ReadAsStringAsync();
</string>

必须 await，否则可能死锁（尤其 WinForms/WPF 同步上下文里）
FormUrlEncodedContent 会自动设 Content-Type 头，别手动覆盖
如果服务端要求 charset=utf-8，它默认已带；但某些老旧系统要 charset=gb2312，就得自己构造 StringContent

怎么发 JSON POST（主流 API 场景）

现代 REST API 几乎都用 application/json。别用 JsonConvert.SerializeObject 拼字符串再包 StringContent —— 容易错失序列化配置（如日期格式、空值忽略）：

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

var client = new HttpClient();
var payload = new { name = "张三", age = 28 };
var json = JsonSerializer.Serialize(payload); // .NET 5+ 原生支持
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.example.com/users", content);

.NET Core 3.0+ 优先用 System.Text.Json，比 Newtonsoft.Json 更快更轻，且默认 UTF-8
若必须用 Newtonsoft.Json，确保调用 JsonConvert.SerializeObject(obj, new JsonSerializerSettings { ... }) 显式控制行为
别漏设 Content-Type，否则服务端可能拒收或解析成字符串

POST 时怎么传文件（multipart/form-data）

上传文件不能用 FormUrlEncodedContent，得用 MultipartFormDataContent。注意字段顺序、文件名、流生命周期：

var client = new HttpClient();
var multipart = new MultipartFormDataContent();

// 普通字段
multipart.Add(new StringContent("report_2024", Encoding.UTF8), "title");

// 文件字段（注意：FileStream 必须保持打开直到请求结束）
using var fileStream = File.OpenRead(@"C:\data.pdf");
multipart.Add(new StreamContent(fileStream), "file", "data.pdf");

var response = await client.PostAsync("https://api.example.com/upload", multipart);

StreamContent 不会自动关闭流，务必确保 fileStream 在 PostAsync 完成后再释放（用 using 包住整个请求块，或手动 Dispose）
第二个参数 "file" 是表单字段名（<input name="file">），第三个是服务端看到的文件名，二者常不同
大文件上传建议加 CancellationToken 和进度回调（需自定义 HttpContent 子类，标准库不直接支持）

常见坑与必须检查项

90% 的 POST 失败不是代码写错，而是环境或配置疏忽：

HttpClient 实例应复用（全局单例或 DI 注入），别每次请求都 new —— 否则触发端口耗尽（SocketException: Too many open files）
证书错误（HttpRequestException: The SSL connection could not be established）：开发时可临时加 client.DefaultRequestHeaders.Add("User-Agent", "...") 排查是否被 WAF 拦截；生产环境必须修复证书链，别用 ServerCertificateCustomValidationCallback 直接返回 true
超时默认是 100 秒，但很多 API 要求 30 秒内响应，记得设 client.Timeout = TimeSpan.FromSeconds(30)
跨域请求（CORS）失败？那是浏览器拦的，HttpClient 本身不走 CORS 检查 —— 别在服务端代码里瞎调 AllowAnyOrigin()，先确认你是在服务端调用还是前端 JS 调用