如何通过ASP.NET WebForms上传包含子文件夹的完整目录？

阿华AIGC实验室

2026-5-15

上传包含子文件夹的文件夹方案（含ASP.NET WebForms实现）

让我来一步步解答你的两个问题——这些都是文件夹上传场景里的常见痛点，我在实际项目中也处理过类似需求：

一、如何上传包含子文件夹的文件夹？

上传带完整目录结构的文件夹，核心是在客户端拿到文件的相对路径信息，然后在服务器端根据这个路径重建目录。目前主要有两种靠谱的实现方式：

前端原生目录选择（依赖现代浏览器支持）
现在Chrome、Firefox、Edge这些主流浏览器都支持HTML5的directory属性（早期是webkit的私有前缀webkitdirectory）。用这个属性的文件选择框，用户可以直接选择整个文件夹，而且每个选中的文件都会附带webkitRelativePath（现在标准属性是relativePath）字段，这个字段就是文件在原文件夹里的相对路径，比如subfolder/docs/report.pdf。
举个前端代码例子：
```
<input type="file" id="folderPicker" webkitdirectory directory multiple>
```
你需要用JS把每个文件的相对路径和文件本身一起提交到服务器，服务端拿到路径后就能自动创建子文件夹并保存文件了。
压缩后上传（兼容性拉满）
这就是你提到的备选方案，也是兼容性最广的方式——让用户先把文件夹压缩成ZIP，上传压缩包后，服务器端用解压工具（比如.NET自带的System.IO.Compression.ZipArchive）解压，直接还原整个目录结构。这种方式不挑浏览器，连IE都能完美支持。

二、ASP.NET WebForms能否实现直接上传完整目录？

你之前提到webkitdirectory只能兼容Chrome且无法保留结构，其实这里有个小误区：它是可以保留子文件夹结构的，只是需要正确处理文件的相对路径信息。下面是具体的实现步骤，亲测可行：

1. 前端页面配置

在WebForms页面里，用HtmlInputFile控件（或者原生HTML输入框）开启目录选择，因为默认的FileUpload服务器控件不支持这个特性：

<asp:HtmlInputFile ID="folderUpload" runat="server" webkitdirectory directory multiple />
<asp:Button ID="btnStartUpload" runat="server" Text="上传文件夹" OnClick="btnStartUpload_Click" />

这里需要用JS把每个文件的webkitRelativePath存到隐藏字段里，或者直接在提交时把路径信息附加到请求里，方便服务器端获取。

2. 服务器端处理逻辑

在按钮的点击事件里，遍历Request.Files集合，拿到每个文件的相对路径，然后创建对应的子文件夹并保存文件：

protected void btnStartUpload_Click(object sender, EventArgs e)
{
    // 服务器上的根保存目录，比如放到App_Data下的Uploads文件夹
    string rootSaveDir = Server.MapPath("~/App_Data/Uploads");
    if (!Directory.Exists(rootSaveDir))
    {
        Directory.CreateDirectory(rootSaveDir);
    }

    foreach (string fileKey in Request.Files)
    {
        HttpPostedFile uploadedFile = Request.Files[fileKey];
        if (uploadedFile.ContentLength == 0) continue;

        // 获取文件的相对路径——这里可以通过前端隐藏字段传递，或者解析请求头
        // 示例：从请求头的Content-Disposition里解析（不同浏览器格式略有差异）
        string contentDisposition = uploadedFile.Headers["Content-Disposition"];
        string relativeFilePath = Regex.Match(contentDisposition, @"filename\*=UTF-8''(.*)").Groups[1].Value;

        if (!string.IsNullOrEmpty(relativeFilePath))
        {
            // 拼接完整的保存路径
            string fullSavePath = Path.Combine(rootSaveDir, relativeFilePath);
            // 创建子文件夹（如果不存在的话）
            string targetDir = Path.GetDirectoryName(fullSavePath);
            if (!Directory.Exists(targetDir))
            {
                Directory.CreateDirectory(targetDir);
            }
            // 保存文件
            uploadedFile.SaveAs(fullSavePath);
        }
    }
}