ASP.NET 2.0 資料教程：檔案上傳基礎 (FileUpload 控制項、伺服器儲存、資料庫關聯)

ASP.NET 2.0 引入 FileUpload 控制項，簡化檔案上傳開發。本文建立完整教學專案結構，示範單檔上傳、伺服器儲存路徑管理、檔案類型驗證、與資料庫路徑欄位關聯，為後續二進位資料 CRUD 奠基。

專案結構規劃

WebApp/
├── BinaryData/                 # 本教學區資料夾
│   ├── Default.aspx            # 區首頁 (含 SectionLevelTutorialListing)
│   ├── FileUpload.aspx         # 基礎上傳示範
│   ├── DisplayOrDownload.aspx  # 顯示/下載二進位資料
│   ├── UploadInDetailsView.aspx# DetailsView 整合上傳
│   └── UpdatingAndDeleting.aspx# 編輯刪除二進位資料
├── App_Data/                   # 資料庫檔案 (Northwind.mdf)
├── Brochures/                  # 小冊子實體檔案目錄 (需寫入權限)
└── Images/                     # 通用圖片目錄

FileUpload.aspx：基礎單檔上傳

<%@ Page Language="C#" MasterPageFile="~/Site.master" %>
<asp:Content ID="Content1" ContentPlaceHolderID="MainContent" runat="server">

<h2>檔案上傳基礎示範</h2>

<asp:FileUpload ID="fuFile" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="上傳" OnClick="btnUpload_Click" />
<br />

<asp:Label ID="lblStatus" runat="server" ForeColor="Green" />
<asp:Label ID="lblError" runat="server" ForeColor="Red" Visible="false" />

</asp:Content>

protected void btnUpload_Click(object sender, EventArgs e)
{
    if (!fuFile.HasFile)
    {
        lblError.Text = "請選擇檔案";
        lblError.Visible = true;
        return;
    }

    // 1. 驗證副檔名
    string ext = Path.GetExtension(fuFile.FileName).ToLower();
    string[] allowed = { ".jpg", ".jpeg", ".png", ".gif", ".pdf", ".doc", ".docx" };
    if (!allowed.Contains(ext))
    {
        lblError.Text = $"不支援的檔案類型：{ext}";
        lblError.Visible = true;
        return;
    }

    // 2. 驗證大小 (2MB)
    if (fuFile.FileBytes.Length > 2 * 1024 * 1024)
    {
        lblError.Text = "檔案不可超過 2MB";
        lblError.Visible = true;
        return;
    }

    // 3. 產生唯一檔名 (Guid + 原副檔名)
    string fileName = Guid.NewGuid().ToString("N") + ext;
    string savePath = Server.MapPath("~/Uploads/") + fileName;

    // 4. 確保目錄存在
    string dir = Path.GetDirectoryName(savePath);
    if (!Directory.Exists(dir)) Directory.CreateDirectory(dir);

    // 5. 儲存
    try
    {
        fuFile.SaveAs(savePath);
        lblStatus.Text = $"上傳成功：{fileName} ({fuFile.FileBytes.Length:N0} bytes)";
        
        // 6. 記錄至資料庫 (此處略)
        // INSERT INTO Documents (FileName, FilePath, ContentType, Size, UploadDate) VALUES (...)
    }
    catch (Exception ex)
    {
        lblError.Text = "儲存失敗：" + ex.Message;
        lblError.Visible = true;
    }
}

Web.config 大檔案設定 (回顧)

<system.web>
  <httpRuntime maxRequestLength="20480" executionTimeout="120" /> <!-- 20MB, 2分鐘 -->
</system.web>
<system.webServer>
  <security>
    <requestFiltering>
      <requestLimits maxAllowedContentLength="20971520" /> <!-- 20MB Bytes -->
    </requestFiltering>
  </security>
</system.webServer>

上傳目錄權限設定

• IIS 應用程式集區身分識別 (通常為 IIS_IUSRS、NETWORK SERVICE) 需具備 ~/Uploads/、~/Brochures/ 目錄的 讀取/寫入/修改 權限。
• 生產環境建議將上傳目錄移至 網站根目錄外，防止直接 URL 存取執行腳本。
• 上傳目錄 web.config 禁用腳本執行：

<configuration>
  <system.webServer>
    <handlers>
      <clear />
      <add name="StaticFile" path="*" verb="*" type="System.Web.StaticFileHandler" resourceType="File" requireAccess="Read" />
    </handlers>
  </system.webServer>
</configuration>

資料庫關聯設計

Categories 擴充欄位：

ALTER TABLE Categories ADD BrochurePath NVARCHAR(255) NULL; -- PDF 路徑
-- Picture 欄位已存在 (varbinary/image)，存圖片二進位

通用文件表設計：

CREATE TABLE Documents (
    DocID INT IDENTITY PRIMARY KEY,
    FileName NVARCHAR(255) NOT NULL,
    StoredFileName NVARCHAR(255) NOT NULL, -- Guid 命名
    FilePath NVARCHAR(500) NOT NULL,       -- 相對路徑 ~/Uploads/xxx.pdf
    ContentType NVARCHAR(100),
    FileSize BIGINT,
    UploadDate DATETIME DEFAULT GETDATE(),
    UploadedBy NVARCHAR(100),
    CategoryID INT NULL FOREIGN KEY REFERENCES Categories(CategoryID)
);

常見問題排查

結語

FileUpload 控制項提供基礎上傳功能，生產級應用需補強：驗證 (型別/大小/內容)、命名策略 (Guid/雜湊)、權限隔離 (目錄外/禁用執行)、資料庫關聯 (中繼資料)、大檔案支援 (分塊/雲端直傳)。後續教學將展示 DetailsView 整合、編輯刪除、二進位顯示完整流程。