如何使用C# WebClient上传数组类型的请求参数？

你遇到的核心问题是NameValueCollection会自动合并相同键的多个值，而服务器期望的是像curl那样重复出现的键名（比如type_pj[]=xxx多次）。好在你已经发现HttpValueCollection能生成正确的URL编码字符串，我们只需要把它和WebClient的UploadData方法结合起来就能实现需求。

方案1：使用HttpValueCollection（.NET Framework） #

HttpValueCollection（来自System.Web命名空间）会保留重复的键，并且它的ToString()方法会生成符合服务器要求的URL编码字符串——每个重复的键都会作为独立的键值对存在，不会被合并。我们可以利用这一点来构建请求体，再用WebClient.UploadData发送：

步骤1：修改/新增调用方法 #

using System.Web; // 需要引入System.Web程序集
using System.Net;

public string CallWebServiceWithArrayParams(string url, HttpValueCollection parameters, string httpVerb = "GET")
{
    using (WebClient myWebClient = new WebClient())
    {
        // 设置正确的Content-Type，和curl的-d参数保持一致
        myWebClient.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
        
        // 将HttpValueCollection生成的参数字符串转为字节数组（用UTF-8编码，可根据需求调整）
        byte[] requestData = Encoding.UTF8.GetBytes(parameters.ToString());
        
        // 发送请求并获取响应
        byte[] responseBytes = myWebClient.UploadData(url, httpVerb, requestData);
        
        // 处理响应编码（复用你原有的逻辑）
        Encoding encoding = WebUtils.GetEncodingFrom(myWebClient.ResponseHeaders, Encoding.Default);
        return encoding.GetString(responseBytes);
    }
}

步骤2：调用方法构建参数 #

// 构建包含重复键的参数集合
var paramCollection = HttpUtility.ParseQueryString(string.Empty);
paramCollection.Add("type_pj[]", "99_AU");
paramCollection.Add("type_pj[]", "41_NC");
paramCollection.Add("type_pj[]", "41_NC");
paramCollection.Add("withcomma", "text,with,comma");

// 发送PATCH请求
string result = CallWebServiceWithArrayParams("https://your-api-url", paramCollection, "PATCH");

这样发送的请求体和你用curl命令生成的完全一致，服务器就能正确识别出包含3个元素的数组。

方案2：手动构建参数字符串（.NET Core/.NET 5+） #

如果你用的是.NET Core或更高版本，System.Web命名空间不再默认提供，这时候可以手动构建键值对列表，然后拼接成符合要求的URL编码字符串：

代码实现 #

using System.Net;
using System.Collections.Generic;
using System.Linq;

public string CallWebServiceWithArrayParams(string url, List<KeyValuePair<string, string>> parameters, string httpVerb = "GET")
{
    using (WebClient myWebClient = new WebClient())
    {
        myWebClient.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
        
        // 手动拼接并编码每个键值对
        string requestString = string.Join("&", parameters.Select(kvp => 
            $"{Uri.EscapeDataString(kvp.Key)}={Uri.EscapeDataString(kvp.Value)}"));
        
        byte[] requestData = Encoding.UTF8.GetBytes(requestString);
        byte[] responseBytes = myWebClient.UploadData(url, httpVerb, requestData);
        
        Encoding encoding = WebUtils.GetEncodingFrom(myWebClient.ResponseHeaders, Encoding.Default);
        return encoding.GetString(responseBytes);
    }
}

// 调用示例
var paramList = new List<KeyValuePair<string, string>>
{
    new KeyValuePair<string, string>("type_pj[]", "99_AU"),
    new KeyValuePair<string, string>("type_pj[]", "41_NC"),
    new KeyValuePair<string, string>("type_pj[]", "41_NC"),
    new KeyValuePair<string, string>("withcomma", "text,with,comma")
};

string result = CallWebServiceWithArrayParams("https://your-api-url", paramList, "PATCH");

为什么原来的UploadValues不行？ #

WebClient.UploadValues方法内部依赖NameValueCollection，而这个集合的设计就是合并相同键的多个值为逗号分隔的字符串——这就是为什么服务器收到的是99_AU,41_NC,41_NC而不是三个独立的参数。而我们上面的方案绕过了这个合并逻辑，直接发送了服务器期望的重复键值对结构。

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