ASP.NET WebForms：UpdatePanel中FileUpload上传至SQL Server失败问题

核心问题原因 #

FileUpload控件依赖完整的表单回传（包含multipart/form-data编码），而AsyncPostBackTrigger触发的异步回传不会发送文件二进制内容，因此无法通过FileUpload.HasFile获取文件；若改用PostBackTrigger，整页回传后模态框会因页面刷新而消失。

方案一：使用PostBackTrigger并回传后重新显示模态框 #

这是最贴近原有代码的修改方案，只需调整触发器并添加回传后显示模态框的逻辑：

1. 修改UpdatePanel的触发器
   将原AsyncPostBackTrigger替换为PostBackTrigger：

<asp:UpdatePanel ID="upModalCargarArchivos" runat="server" UpdateMode="Conditional">
    <!-- 内容模板保持不变 -->
    <Triggers>
        <asp:PostBackTrigger ControlID="btnCargarArchivos" />
    </Triggers>
</asp:UpdatePanel>

2. 回传后重新显示模态框
   在Page_Load事件中判断是否为上传按钮触发的回传，若为真则注册脚本重新唤起模态框：

protected void Page_Load(object sender, EventArgs e)
{
    if (IsPostBack && Request.Params["__EVENTTARGET"] == btnCargarArchivos.UniqueID)
    {
        // 注册Bootstrap模态框显示脚本
        ScriptManager.RegisterStartupScript(this, GetType(), "ShowUploadModal", "$('#modalCargarArchivos').modal('show');", true);
    }
}

3. 验证服务器端逻辑
   此时完整回传会包含文件内容，FileUpload1.HasFile即可正常获取状态：

protected void btnCargarArchivos_Click(object sender, EventArgs e)
{
    if (FileUpload1.HasFile)
    {
        // 获取文件信息并写入SQL Server
        byte[] fileContent = FileUpload1.FileBytes;
        string fileName = FileUpload1.FileName;
        string contentType = FileUpload1.PostedFile.ContentType;

        // 此处添加数据库插入逻辑，示例：
        // using (SqlConnection conn = new SqlConnection(ConfigurationManager.ConnectionStrings["YourConnString"].ConnectionString))
        // {
        //     string sql = "INSERT INTO Files (FileName, ContentType, FileContent) VALUES (@FileName, @ContentType, @FileContent)";
        //     SqlCommand cmd = new SqlCommand(sql, conn);
        //     cmd.Parameters.AddWithValue("@FileName", fileName);
        //     cmd.Parameters.AddWithValue("@ContentType", contentType);
        //     cmd.Parameters.AddWithValue("@FileContent", fileContent);
        //     conn.Open();
        //     cmd.ExecuteNonQuery();
        // }

        lblMensajeModalCargarArchivos.Text = "文件上传成功";
        lblMensajeModalCargarArchivos.CssClass = "alert-success";
    }
    else
    {
        lblMensajeModalCargarArchivos.Text = "未选择文件";
        lblMensajeModalCargarArchivos.CssClass = "alert-danger";
    }
}

方案二：使用AJAX异步上传（推荐，无整页刷新） #

通过前端AJAX配合一般处理程序（ASHX）实现无刷新上传，彻底避免UpdatePanel回传问题：

1. 修改前端按钮逻辑
   修改cargarArchivos()函数，取消服务器端回传，改用FormData发送文件：

function cargarArchivos() {
    var fileInput = document.getElementById('<%= FileUpload1.ClientID %>');
    var messageLabel = document.getElementById('<%= lblMensajeModalCargarArchivos.ClientID %>');
    
    if (fileInput.files.length === 0) {
        messageLabel.textContent = "请选择要上传的文件";
        messageLabel.className = "alert-danger";
        return false;
    }

    var formData = new FormData();
    formData.append("uploadFile", fileInput.files[0]);

    $.ajax({
        url: "FileUploadHandler.ashx",
        type: "POST",
        data: formData,
        contentType: false,
        processData: false,
        success: function (response) {
            var result = JSON.parse(response);
            if (result.success) {
                messageLabel.textContent = "文件上传成功";
                messageLabel.className = "alert-success";
                // 可选：清空文件选择框
                fileInput.value = "";
            } else {
                messageLabel.textContent = result.message;
                messageLabel.className = "alert-danger";
            }
        },
        error: function () {
            messageLabel.textContent = "上传过程出错，请重试";
            messageLabel.className = "alert-danger";
        }
    });

    return false; // 阻止服务器端按钮回传
}

2. 创建一般处理程序（FileUploadHandler.ashx）
   新建ASHX文件处理文件上传并写入数据库：

public class FileUploadHandler : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        context.Response.ContentType = "application/json";
        try
        {
            if (context.Request.Files.Count > 0)
            {
                HttpPostedFile postedFile = context.Request.Files["uploadFile"];
                byte[] fileBytes;
                using (BinaryReader reader = new BinaryReader(postedFile.InputStream))
                {
                    fileBytes = reader.ReadBytes(postedFile.ContentLength);
                }

                // 写入SQL Server数据库逻辑
                string connString = System.Configuration.ConfigurationManager.ConnectionStrings["YourConnString"].ConnectionString;
                using (System.Data.SqlClient.SqlConnection conn = new System.Data.SqlClient.SqlConnection(connString))
                {
                    string sql = "INSERT INTO Files (FileName, ContentType, FileSize, FileContent) VALUES (@FileName, @ContentType, @FileSize, @FileContent)";
                    System.Data.SqlClient.SqlCommand cmd = new System.Data.SqlClient.SqlCommand(sql, conn);
                    cmd.Parameters.AddWithValue("@FileName", postedFile.FileName);
                    cmd.Parameters.AddWithValue("@ContentType", postedFile.ContentType);
                    cmd.Parameters.AddWithValue("@FileSize", postedFile.ContentLength);
                    cmd.Parameters.AddWithValue("@FileContent", fileBytes);
                    conn.Open();
                    cmd.ExecuteNonQuery();
                }

                context.Response.Write("{\"success\": true, \"message\": \"文件上传成功\"}");
            }
            else
            {
                context.Response.Write("{\"success\": false, \"message\": \"未检测到上传文件\"}");
            }
        }
        catch (Exception ex)
        {
            context.Response.Write($"{{\"success\": false, \"message\": \"{ex.Message}\"}}");
        }
    }

    public bool IsReusable => false;
}

3. 移除UpdatePanel触发器（可选）
   因为使用了AJAX异步上传，UpdatePanel的触发器可以移除，或者保留用于其他异步逻辑。

额外配置：调整上传大小限制 #

若上传大文件，需修改web.config配置：

<system.web>
    <!-- 最大请求长度，单位KB，示例为1GB -->
    <httpRuntime maxRequestLength="1048576" executionTimeout="3600" />
</system.web>
<system.webServer>
    <security>
        <requestFiltering>
            <!-- 最大允许内容长度，单位字节，示例为1GB -->
            <requestLimits maxAllowedContentLength="1073741824" />
        </requestFiltering>
    </security>
</system.webServer>

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