如何在ASP.NET中使用FileUpload1控件实现异步文件上传？

问题根源 #

1. FileUpload的onchange事件绑定错误：你给FileUpload1设置了onchange="UpLoad_Button_Click"，但UpLoad_Button_Click是服务器端方法，客户端onchange事件无法直接调用它，会导致脚本报错、表单提交异常，最终后台无法获取FileUpload中的文件。
2. 同步回发不等于异步上传：默认ASP.NET按钮点击会触发整页刷新，要实现异步上传需要额外处理。

解决步骤 #

第一步：修复基础上传功能（解决FileUpload为空问题） #

首先删除FileUpload控件中错误的onchange属性：

<asp:FileUpload ID="FileUpload1" runat="server" 
     BorderColor="Silver" BorderStyle="None" 
     Height="30px" Width="189px" />  

完善后台代码逻辑，添加必要判断和资源自动释放：

protected void UpLoad_Button_Click(object sender, EventArgs e)
{
    if (FileUpload1.HasFile)
    {
        string extension = System.IO.Path.GetExtension(FileUpload1.PostedFile.FileName);
        // 可添加文件类型限制，比如仅允许文本文件
        if (extension.Equals(".txt", StringComparison.OrdinalIgnoreCase))
        {
            // 使用using自动释放StreamReader资源
            using (StreamReader readTextFile = new StreamReader(FileUpload1.FileContent, Encoding.UTF8))
            {
                TextBox1.Text = readTextFile.ReadToEnd();
            }
        }
        else
        {
            TextBox1.Text = "仅支持上传TXT格式文件";
        }
    }
    else
    {
        TextBox1.Text = "请先选择要上传的文件";
    }
}

第二步：实现异步上传（无整页刷新） #

如果需要无页面刷新的上传效果，可使用UpdatePanel配合PostBackTrigger：

<asp:ScriptManager ID="ScriptManager1" runat="server"></asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
    <ContentTemplate>
        <asp:FileUpload ID="FileUpload1" runat="server" 
             BorderColor="Silver" BorderStyle="None" 
             Height="30px" Width="189px" />  
        <asp:Button ID="UpLoad_Button" runat="server" 
             OnClick="UpLoad_Button_Click" Text="Upload" 
             BorderColor="black" BorderStyle="Dashed" />
        <asp:TextBox ID="TextBox1" runat="server" TextMode="MultiLine" Rows="10" Width="300px"></asp:TextBox>
    </ContentTemplate>
    <Triggers>
        <!-- FileUpload在UpdatePanel中必须使用PostBackTrigger才能正常工作 -->
        <asp:PostBackTrigger ControlID="UpLoad_Button" />
    </Triggers>
</asp:UpdatePanel>

注：这种方式下按钮点击会触发该控件的同步回发，但页面其他部分不会刷新。如果需要纯AJAX无刷新上传，建议使用AsyncFileUpload控件或自行编写前端AJAX配合后端接口接收文件。

额外注意事项 #

• 若需将文件保存到服务器，确保目标目录具备写入权限。
• 在web.config中设置足够的上传文件大小限制：

<configuration>
  <system.web>
    <httpRuntime maxRequestLength="1048576" /> <!-- 限制1GB，单位KB -->
  </system.web>
  <!-- IIS 7及以上版本需添加以下配置 -->
  <system.webServer>
    <security>
      <requestFiltering>
        <requestLimits maxAllowedContentLength="1073741824" /> <!-- 限制1GB，单位字节 -->
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

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