如何在C#中实现类似PHP的CURLFile对象以完成文件上传？

问题背景 #

我是C#新手，正在编写WinForm代码实现文件上传至服务器，此前使用PHP开发，目前已完成大部分工作但遇到一个问题。

在PHP中，我使用curl_file_create创建CURLFile对象，再将其添加到CURL参数中，代码如下：

$filename = "d:/1.zip";
$fileTitle = "[Test]1.zip";
$data["sess_id"] = $sess_id;
$data["file"] = curl_file_create($filename, mime_content_type($filename), $fileTitle);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$output = curl_exec($ch);
$httpInfo = curl_getinfo($ch);

该函数创建的CURLFile对象结构如下：

object(CURLFile)[1]
  public 'name' => string 'd:/1.zip' (length=8)
  public 'mime' => string 'application/zip' (length=15)
  public 'postname' => string '[test]1.zip' (length=11)

我的C#代码如下：

string filename = "d:/1.zip";
string fileTitle = "[Test]1.zip";
string parameters = "sess_id=" + sess_id;
byte[] dataParameters = Encoding.UTF8.GetBytes(parameters);
webRequest = (HttpWebRequest)HttpWebRequest.Create(uploadUrl);
webRequest.Method = "POST";
webRequest.UserAgent = "Mozilla/5.0 (Encoder 1.0.0）";
webRequest.ContentType = "application/x-www-form-urlencoded";
webRequest.ContentLength = dataParameters.Length;
using (Stream webStream = webRequest.GetRequestStream())
{
    webStream.Write(dataParameters, 0, dataParameters.Length);
}
webResponse = (HttpWebResponse)webRequest.GetResponse();

请问如何在C#中创建用于上传的CURLFile对象？或者有其他实现方法吗？

解决方案 #

首先需要明确：你当前C#代码使用的application/x-www-form-urlencoded格式无法上传文件，PHP中curl_file_create实际是通过multipart/form-data格式提交请求，C#中不需要专门的"CURLFile对象"，只需构造对应的multipart/form-data请求即可，以下是两种实现方式：

方法一：使用HttpClient（推荐，.NET Framework 4.5+支持） #

HttpClient是更现代的HTTP客户端，代码简洁易维护：

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

// WinForm中调用时需使用async/await
private async Task UploadFileAsync(string uploadUrl, string sessId, string filePath, string fileTitle)
{
    using (var httpClient = new HttpClient())
    {
        // 设置UserAgent
        httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("Mozilla/5.0 (Encoder 1.0.0）");
        
        using (var formData = new MultipartFormDataContent())
        {
            // 添加sess_id参数
            formData.Add(new StringContent(sessId), "sess_id");
            
            // 读取文件内容并构造文件上传部分
            var fileBytes = File.ReadAllBytes(filePath);
            var fileContent = new ByteArrayContent(fileBytes);
            // 设置文件MIME类型，对应CURLFile的mime属性
            fileContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue(GetMimeType(filePath));
            // 添加文件到表单，第三个参数对应CURLFile的postname属性（服务器接收的文件名）
            formData.Add(fileContent, "file", fileTitle);
            
            // 发送请求
            var response = await httpClient.PostAsync(uploadUrl, formData);
            response.EnsureSuccessStatusCode(); // 确保请求成功
            var responseContent = await response.Content.ReadAsStringAsync();
            // 这里可以处理服务器返回的响应内容
        }
    }
}

// 辅助方法：获取文件的MIME类型
private string GetMimeType(string filePath)
{
    var defaultMime = "application/octet-stream";
    var fileExt = Path.GetExtension(filePath).ToLowerInvariant();
    
    // 从注册表获取对应扩展名的MIME类型
    using (var regKey = Microsoft.Win32.Registry.ClassesRoot.OpenSubKey(fileExt))
    {
        if (regKey != null && regKey.GetValue("Content Type") != null)
        {
            return regKey.GetValue("Content Type").ToString();
        }
    }
    return defaultMime;
}

方法二：使用HttpWebRequest（兼容旧版本.NET Framework） #

如果需要兼容较旧的.NET Framework版本，可以手动构造multipart/form-data请求：

using System;
using System.IO;
using System.Net;
using System.Text;

private void UploadFile(string uploadUrl, string sessId, string filePath, string fileTitle)
{
    // 生成随机边界符，用于分隔表单内容
    string boundary = $"----WebKitFormBoundary{Guid.NewGuid():N}";
    
    var webRequest = (HttpWebRequest)WebRequest.Create(uploadUrl);
    webRequest.Method = "POST";
    webRequest.UserAgent = "Mozilla/5.0 (Encoder 1.0.0）";
    webRequest.ContentType = $"multipart/form-data; boundary={boundary}";
    webRequest.KeepAlive = true;

    using (var requestStream = webRequest.GetRequestStream())
    {
        // 写入sess_id参数
        var paramContent = $"--{boundary}\r\nContent-Disposition: form-data; name=\"sess_id\"\r\n\r\n{sessId}\r\n";
        var paramBytes = Encoding.UTF8.GetBytes(paramContent);
        requestStream.Write(paramBytes, 0, paramBytes.Length);

        // 写入文件上传部分
        var fileBytes = File.ReadAllBytes(filePath);
        var fileHeader = $"--{boundary}\r\nContent-Disposition: form-data; name=\"file\"; filename=\"{fileTitle}\"\r\nContent-Type: {GetMimeType(filePath)}\r\n\r\n";
        var fileHeaderBytes = Encoding.UTF8.GetBytes(fileHeader);
        
        requestStream.Write(fileHeaderBytes, 0, fileHeaderBytes.Length);
        requestStream.Write(fileBytes, 0, fileBytes.Length);

        // 写入请求结束边界
        var endContent = $"\r\n--{boundary}--\r\n";
        var endBytes = Encoding.UTF8.GetBytes(endContent);
        requestStream.Write(endBytes, 0, endBytes.Length);
    }

    // 处理服务器响应
    using (var webResponse = (HttpWebResponse)webRequest.GetResponse())
    {
        using (var responseStream = webResponse.GetResponseStream())
        {
            if (responseStream != null)
            {
                using (var reader = new StreamReader(responseStream))
                {
                    string responseContent = reader.ReadToEnd();
                    // 处理响应内容
                }
            }
        }
    }
}

// 同样的MIME类型获取方法
private string GetMimeType(string filePath)
{
    var defaultMime = "application/octet-stream";
    var fileExt = Path.GetExtension(filePath).ToLowerInvariant();
    
    using (var regKey = Microsoft.Win32.Registry.ClassesRoot.OpenSubKey(fileExt))
    {
        if (regKey != null && regKey.GetValue("Content Type") != null)
        {
            return regKey.GetValue("Content Type").ToString();
        }
    }
    return defaultMime;
}

说明 #

PHP的curl_file_create本质是在multipart/form-data请求中封装了文件的本地路径、MIME类型和服务器接收的文件名，C#中通过MultipartFormDataContent（HttpClient方式）或手动构造请求内容（HttpWebRequest方式）就能实现完全相同的效果，推荐优先使用HttpClient，代码更简洁且不易出错。

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