ASP.NET 2.0 資料教程 48：SqlDataSource 參數化查詢完整指南

參數化查詢可防止 SQL Injection、提升計畫重用。本教程涵蓋宣告式與程式化兩種參數指定方式。

參數來源類型

宣告式範例：依查詢字串篩選產品

<asp:SqlDataSource ID="ProductsDS" runat="server"
    ConnectionString="%$ ConnectionStrings:Northwind %$"
    SelectCommand="SELECT ProductID, ProductName, UnitPrice FROM Products WHERE CategoryID = @CategoryID">
    <SelectParameters>
        <asp:QueryStringParameter Name="CategoryID" QueryStringField="cat" Type="Int32" DefaultValue="1" />
    </SelectParameters>
</asp:SqlDataSource>

程式化指定參數：Selecting 事件

protected void ProductsDS_Selecting(object sender, SqlDataSourceSelectingEventArgs e)
{
    // 依據複雜商務邏輯動態決定參數
    if (User.IsInRole("Admin"))
        e.Command.Parameters["@CategoryID"].Value = DBNull.Value; // 全部分類
    else
        e.Command.Parameters["@CategoryID"].Value = GetUserDefaultCategory();
}

多參數組合查詢範例

SelectCommand="SELECT * FROM Products WHERE 
    (@CategoryID IS NULL OR CategoryID = @CategoryID) AND
    (@MinPrice IS NULL OR UnitPrice >= @MinPrice) AND
    (@MaxPrice IS NULL OR UnitPrice <= @MaxPrice)"

<SelectParameters>
    <asp:QueryStringParameter Name="CategoryID" QueryStringField="cat" Type="Int32" ConvertEmptyStringToNull="true" />
    <asp:ControlParameter Name="MinPrice" ControlID="txtMin" PropertyName="Text" Type="Decimal" ConvertEmptyStringToNull="true" />
    <asp:ControlParameter Name="MaxPrice" ControlID="txtMax" PropertyName="Text" Type="Decimal" ConvertEmptyStringToNull="true" />
</SelectParameters>

關鍵屬性：ConvertEmptyStringToNull

設為 true 時，空字串自動轉為 NULL，搭配 `IS NULL` 判斷可實現「未輸入即不篩選」效果。

儲存程序參數

同樣支援參數化，參數名稱需與 SP 定義一致 (含 @ 前綴)，方向可設 Input/Output/ReturnValue。

1. 上一篇文章： ASP.NET 2.0 資料教程 49：SqlDataSource 插入、更新、刪除完整教學
2. 下一篇文章： ASP.NET 2.0 資料教程 47：SqlDataSource 基礎查詢與 ObjectDataSource 比較

關於ASP.NET

Enterprise Library 2.0 Hands On Lab 翻譯（7）：例外處理應用程式區塊（一）

練習 1：記錄例外資訊 在無例外處理的應用程式中加入例外處理

ASP.NET 網絡硬盤實作 (二)：檔案下載與線上預覽

下載實作：Response.TransmitFile / B

LINQ 入門實戰：從陣列篩選偶數看查詢語法與方法語法的對比

範例需求 給定整數陣列 {12, 234, 15, 4325

體驗 ASP.NET MVC Preview 5 (1)：探索 ViewEngine 原理並比較新舊版

ASP.NET MVC Preview 5 釋出，ViewE