SqlDataSource.SelectCommand 屬性

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得或設定 SQL 字串，SqlDataSource 控制項會用來擷取基礎資料庫的資料。

public:
 property System::String ^ SelectCommand { System::String ^ get(); void set(System::String ^ value); };

public string SelectCommand { get; set; }

member this.SelectCommand : string with get, set

Public Property SelectCommand As String

屬性值

String

SqlDataSource 用來擷取資料的 SQL 字串或預存程序名稱。

範例

本節包含兩個程式碼範例。第一個程式代碼範例示範如何將文字設定 SelectCommand 為基本 SQL 查詢，以從 ODBC 相容的資料庫擷取數據，並將其顯示在控件中 GridView 。第二個程式代碼範例示範如何將文字設定為預存程式的名稱，並將 SelectCommandType 屬性設定SelectCommand為 StoredProcedure 值，以從 Microsoft SQL Server 資料庫擷取數據，並將其顯示在控件中DropDownList。

在這兩個範例中，都不需要明確呼叫 Select 方法，因為透過 DataSourceID 屬性附加至數據源控件的數據綁定控件會在階段期間PreRender自動呼叫 Select 方法。

下列程式代碼範例示範如何將文字設定 SelectCommand 為基本 SQL 查詢，以從 ODBC 相容的資料庫擷取數據，並將其顯示在控件中 GridView 。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->

    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataSet"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataSet"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

下列程式代碼範例示範如何將文字設定為預存程式的名稱，並將 SelectCommandType 屬性設定SelectCommand為 StoredProcedure 值，以從 SQL Server 資料庫擷取數據，並將其顯示在控件中DropDownList。如果數據源支援預存程式，此屬性 SelectCommand 可以是 SQL 查詢或預存程式的名稱。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                DataTextField="LastName"
                DataSourceID="SqlDataSource1" />

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommandType="StoredProcedure"                
                SelectCommand="sp_lastnames">
            </asp:SqlDataSource>

            <!--
                The sp_lastnames stored procedure is
                CREATE PROCEDURE sp_lastnames AS
                   SELECT LastName FROM Employees
                GO
            -->

        </form>
    </body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                DataTextField="LastName"
                DataSourceID="SqlDataSource1" />

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommandType = "StoredProcedure"
                SelectCommand="sp_lastnames">
            </asp:SqlDataSource>

            <!--
                The sp_lastnames stored procedure is
                CREATE PROCEDURE sp_lastnames AS
                   SELECT LastName FROM Employees
                GO
            -->

        </form>
    </body>
</html>

備註

屬性 SelectCommand 代表 SQL 查詢或預存程式的名稱，並由方法用來 Select 從 SQL Server 資料庫擷取數據。如果您在 Select 命令中使用星號 (*) 來選取所有數據行，而且如果您使用自動程式代碼產生來執行更新或刪除作業，請確定其名稱中沒有任何數據行有空格。

由於不同的資料庫產品使用不同的 SQL，SQL 字串的語法須視目前所使用的 ADO.NET 提供者 (可由 ProviderName 屬性識別) 而定。如果 SQL 字串是參數型查詢或命令，參數的替代符號亦須視目前所使用的 ADO.NET 提供者而定。例如，如果提供者是 System.Data.SqlClient，這是類別的預設提供者 SqlDataSource ，則參數的佔位元為 '@parameterName'。不過，如果提供者設定 System.Data.Odbc 為或 System.Data.OleDb，則參數的佔位元為 '?'。如需參數化 SQL 查詢和命令的詳細資訊，請參閱搭配 SqlDataSource 控制項使用參數。

如果數據源支援預存程式，此屬性 SelectCommand 可以是 SQL 字串或預存程式的名稱。

屬性SelectCommand會委派給SelectCommand與 SqlDataSource 控件相關聯之 SqlDataSourceView 對象的屬性。

重要

基於安全性考慮， SelectCommand 屬性不會儲存為檢視狀態。因為可以譯碼用戶端上檢視狀態的內容，所以將資料庫結構的敏感性資訊儲存在檢視狀態可能會導致資訊洩漏弱點。

重要

值會插入參數中，而不需驗證，這是潛在的安全性威脅。在執行查詢之前， Filtering 請使用事件來驗證參數值。如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

適用於

共用方式為

SqlDataSource.SelectCommand 屬性

定義

屬性值

範例

備註

適用於

另請參閱

其他資源