C# http系列之以form-data方式上传多个文件及键值对集合到远程服务器

下面来详细讲解 “C# http系列之以form-data方式上传多个文件及键值对集合到远程服务器”的完整攻略。

标题

一、什么是form-data形式上传

form-data是浏览器用来上传文件的一种编码方式，它会将上传文件和普通表单键值对一并打包上传到服务器上。这种方式相比传统的multipart/form-data编码方式，更加高效。

HTTP的请求格式一般如下所示，其中部分字段可以根据情况省略：

请求方法 URL HTTP/1.1
请求头
请求正文

因此，在使用form-data形式上传时，我们需要将请求正文中的数据打包为相应的格式，并在请求头中指定Content-Type为multipart/form-data。

二、如何使用C#实现以form-data方式上传多个文件及键值对集合到远程服务器

1. 首先，在使用C#发送http请求时，需要引入System.Net.Http命名空间下的HttpClient类。

using System.Net.Http;

2. 首先，构建HttpRequestMessage实例，指定请求方法、URL和Content-Type，以及POST请求对应的HttpContent。

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, "http://your-server.com/upload");

MultipartFormDataContent content = new MultipartFormDataContent();

这里选择使用MultipartFormDataContent类来构建POST请求的HttpContent，它可以很方便地将表单键值对和文件打包成multipart/form-data格式的请求正文。

3. 接下来，将要上传的文件读取到MemoryStream中，并构造StreamContent实例。

FileStream fileStream = new FileStream("test.txt", FileMode.Open);

MemoryStream stream = new MemoryStream();
fileStream.CopyTo(stream);
stream.Seek(0, SeekOrigin.Begin);

HttpContent fileContent = new StreamContent(stream);

content.Add(fileContent, "file", "test.txt");

这里假设要上传的文件名为test.txt，这段代码把test.txt文件读取到一个MemoryStream中，并创建StreamContent对象。然后使用content.Add()方法添加到表单中，第一个参数为要上传文件的HttpContent，第二个参数为该文件在上传时对应的表单键名，第三个参数则为该文件的文件名。

4. 如果需要上传多个文件，可以将上述过程重复多次，或者参照以下示例代码。

string[] files = new string[] { "test.txt", "test2.txt" };

foreach (string file in files)
{
    FileStream fileStream = new FileStream(file, FileMode.Open);

    MemoryStream stream = new MemoryStream();
    fileStream.CopyTo(stream);
    stream.Seek(0, SeekOrigin.Begin);

    HttpContent fileContent = new StreamContent(stream);

    content.Add(fileContent, "file[]", file);
}

这里使用了一个string数组来存储要一次性上传的多个文件名，然后使用foreach循环来依次上传每个文件。

foreach (string file in files)
{
    // ...
    content.Add(fileContent, "file[]", file);
}

需要注意的是，这里在表单键名后面加了一对方括号“[]”，表示该键名对应的值是一个由多个文件组成的数组，这对于同时上传多个文件时是必要的。

5. 如果要上传键值对集合，则可以使用StringContent类来构造请求正文。

Dictionary<string, string> data = new Dictionary<string, string>();
data.Add("key1", "value1");
data.Add("key2", "value2");

foreach (KeyValuePair<string, string> item in data)
{
    content.Add(new StringContent(item.Value), item.Key);
}

这里使用了Dictionary类来存储要上传的键值对集合，然后依次将其添加到请求正文中。

6. 最后，将表单数据附加到HttpRequestMessage实例中，并使用HttpClient类来发送http请求，等待请求结果并输出到控制台。

request.Content = content;

HttpResponseMessage response = client.SendAsync(request).Result;

Console.WriteLine(response.Content.ReadAsStringAsync().Result);

注意，这里使用了Result属性来获取请求结果，是因为异步的HttpClient.SendAsync(...)方法并不会自动等待请求结束，需要手动等待并获取执行结果。

以上就是使用C#实现以form-data方式上传多个文件及键值对集合到远程服务器的完整攻略。可以根据上述过程进行相应的调整和扩展，以满足不同的业务场景需求。