在C#中用WebClient/HttpClient实现文件与文本同请求API调用

没问题！我来帮你用C#的HttpClient和WebClient两种方式，实现和Postman里同时上传文件+文本数据的等价API调用——这本质上就是发送multipart/form-data类型的请求，下面是具体的代码示例和说明：

HttpClient是.NET生态里更现代、灵活的HTTP客户端，官方也更推荐用它来处理HTTP请求。下面的代码会完整实现单次请求里同时传文件和文本参数：

using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class FileUploader
{
    static async Task Main(string[] args)
    {
        // 替换成你的实际API接口地址
        var targetApiUrl = "https://your-api-server.com/upload";
        
        // 文本参数的键名和值（对应Postman里form-data的普通字段）
        var textFieldKey = "file_description";
        var textFieldValue = "这是我要上传的测试文件，附带描述文本";
        
        // 本地要上传的文件路径，确保程序有读取权限
        var localFilePath = @"C:\Documents\test-upload-file.pdf";

        using (var httpClient = new HttpClient())
        using (var multipartContent = new MultipartFormDataContent())
        {
            // 1. 添加文本参数到请求体
            multipartContent.Add(new StringContent(textFieldValue), textFieldKey);

            // 2. 添加文件到请求体
            var fileStream = File.OpenRead(localFilePath);
            var fileStreamContent = new StreamContent(fileStream);
            // 根据你的文件类型设置正确的MIME类型，比如pdf是application/pdf，图片是image/jpeg
            fileStreamContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/pdf");
            // 参数分别是：文件内容、后端接收文件的字段名、传给后端的文件名
            multipartContent.Add(fileStreamContent, "uploaded_file", Path.GetFileName(localFilePath));

            try
            {
                // 发送POST请求
                var response = await httpClient.PostAsync(targetApiUrl, multipartContent);
                // 如果返回非2xx状态码，直接抛出异常
                response.EnsureSuccessStatusCode();

                // 读取并打印响应内容
                var responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine("请求成功！后端响应：");
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException ex)
            {
                Console.WriteLine($"请求失败：{ex.Message}");
            }
            finally
            {
                // 记得关闭文件流
                fileStream.Close();
            }
        }
    }
}

关键点说明： #

• MultipartFormDataContent就是用来构建multipart/form-data请求的容器，完全对应Postman里的form-data选项
• 文本参数用StringContent包装，添加到容器里就和Postman里加的普通key-value字段一致
• 文件用StreamContent读取本地文件流，一定要设置正确的ContentType，后端会靠这个识别文件类型
• 调用Add方法时，第二个参数是后端接收文件的字段名，必须和后端接口定义的一致，别写错哦

如果你因为项目限制需要用WebClient，也可以实现同样的功能，代码如下：

using System;
using System.Net;
using System.IO;
using System.Collections.Specialized;

class LegacyFileUploader
{
    static void Main(string[] args)
    {
        var targetApiUrl = "https://your-api-server.com/upload";
        var textFieldKey = "file_description";
        var textFieldValue = "这是WebClient上传的文件，附带描述";
        var localFilePath = @"C:\Documents\test-upload-file.jpg";

        using (var webClient = new WebClient())
        {
            try
            {
                // 准备要发送的文本参数（放在请求体的form里，不是URL参数）
                var formData = new NameValueCollection();
                formData.Add(textFieldKey, textFieldValue);

                // 上传文件+文本参数，自动封装成multipart/form-data请求
                var responseBytes = webClient.UploadFile(targetApiUrl, "POST", localFilePath, formData);
                var responseBody = System.Text.Encoding.UTF8.GetString(responseBytes);

                Console.WriteLine("请求成功！后端响应：");
                Console.WriteLine(responseBody);
            }
            catch (WebException ex)
            {
                Console.WriteLine($"请求失败：{ex.Message}");
                // 如果后端返回了错误详情，可以读取出来
                if (ex.Response != null)
                {
                    using (var errorReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        Console.WriteLine("后端错误详情：");
                        Console.WriteLine(errorReader.ReadToEnd());
                    }
                }
            }
        }
    }
}

关键点说明： #

• WebClient的UploadFile重载（带NameValueCollection参数）会自动把文件和文本参数打包成multipart/form-data请求
• 如果文本参数不需要放在请求体，而是放在URL的查询字符串里，可以直接用webClient.QueryString.Add()添加
• 捕获WebException时，可以通过ex.Response获取后端返回的错误信息，方便调试

通用注意事项 #

• 替换代码里的targetApiUrl、textFieldKey、textFieldValue和localFilePath为你实际的参数
• 确保程序有读取目标文件的权限，否则会抛出文件访问异常
• 根据文件类型调整ContentType，常见的类型可以查MIME类型对照表
• 后端接口必须支持接收multipart/form-data类型的请求，并且参数名和你代码里的完全匹配

内容的提问来源于stack exchange，提问作者NehaS