### 使用 Multipart/Form-Data 实现文件上传 POST 请求 为了实现基于 `multipart/form-data` 的文件上传 POST 请求，在 C# 中可以利用 `HttpClient` 类来构建和发送请求。下面是一个完整的例子，展示了如何创建这样的请求并将文件连同其他表单数据一起提交给服务器。 #### 构建 HTTP 客户端并准备要上传的数据 首先定义一个方法用来封装整个过程： ```csharp using System; using System.IO; using System.Net.Http; using System.Threading.Tasks; public class FileUploader { public static async Task<string> UploadFileAsync(string url, string filePath, Dictionary<string, string> formData = null) { using var client = new HttpClient(); using var content = new MultipartFormDataContent(); // 添加文件流作为内容的一部分 byte[] fileBytes = await File.ReadAllBytesAsync(filePath); ByteArrayContent byteArrayContent = new ByteArrayContent(fileBytes); // 设置 Content-Disposition header; filename 参数指定了原始文件名 content.Add(byteArrayContent, "uploaded_file", Path.GetFileName(filePath)); // 如果有额外的表单数据，则将其加入到 multipart 内容里 if (formData != null && formData.Count > 0) { foreach (var item in formData) { content.Add(new StringContent(item.Value), item.Key); } } HttpResponseMessage response = await client.PostAsync(url, content); response.EnsureSuccessStatusCode(); // 抛出异常如果响应状态码表示失败 return await response.Content.ReadAsStringAsync(); } } ``` 这段代码实现了几个重要功能：它读取本地磁盘上的文件，并将它们打包进一个多部分 MIME 消息中；还可以附加任意数量的标准键值对形式的表单字段[^1]。 #### 调用此方法执行上传操作 假设有一个 Web API 接口 `/api/upload` 可以接收文件和其他表单数据，调用上面的方法如下所示： ```csharp Dictionary<string, string> additionalFields = new() { { "title", "My awesome photo" }, { "description", "This is a description of my photo." } }; string result = await FileUploader.UploadFileAsync( "https://example.com/api/upload", @"C:\path\to\your\image.jpg", additionalFields ); Console.WriteLine($"Server responded with: {result}"); ``` 这里传递了一个路径指向想要上传的照片以及一些描述性的元数据。当这个异步任务完成之后，会打印出来自服务器对于此次上传行为作出回应的内容[^2]。 #### 处理服务端逻辑 在服务器端接收到带有 `multipart/form-data` 编码的消息时，应该解析消息中的各个部分。这通常涉及到遍历所有传入的部分，区分哪些是常规文本输入项而哪些又是待保存的实际文件附件。具体做法取决于所使用的框架和技术栈[^5]。