QueryStringParameter.QueryStringField 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

取得或設定參數所繫結至的查詢字串欄位名稱。

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

public string QueryStringField { get; set; }

member this.QueryStringField : string with get, set

Public Property QueryStringField As String

屬性值

String

參數繫結的查詢字串欄位名稱。

範例

下列範例示範如何搭配 SqlDataSource 控制項使用 QueryStringParameter 物件，在 控制項中 ListBox 顯示資料。 屬性 QueryStringField 會設定為預期的查詢字串欄位名稱，並將 參數新增至 SelectParameters 集合。 如果名稱/值組未與查詢字串一起傳遞，則會 DefaultValue 提供 屬性。

      <asp:ListBox
        id ="ListBox1"
        runat="server"
        DataSourceID="SqlDataSource1"
        DataValueField="EmployeeID"
        DataTextField="LastName" />
    
<!-- Use a query string that includes empId=1 -->
    
<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:SqlDataSource
        id="SqlDataSource1"
        runat="server"
        ConnectionString="<%$ ConnectionStrings:MyNorthwind %>"
        SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = @empId">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:ListBox
        id ="ListBox1"
        runat="server"
        DataSourceID="SqlDataSource1"
        DataValueField="EmployeeID"
        DataTextField="LastName" />

<!-- Use a query string that includes empId=1 -->

<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:SqlDataSource
        id="SqlDataSource1"
        runat="server"
        ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
        SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = @empId">
        <SelectParameters>
          <asp:QueryStringParameter     Name="empId" QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

下列範例示範如何搭配 SqlDataSource 控制項使用 QueryStringParameter 物件，在 控制項中 GridView 顯示資料。 物件 QueryStringParameter 會新增至 SelectParameters 集合，以及用於輸出參數和傳回值的其他參數物件。 若要擷取資料，請處理從預存程式傳回的值。 此程式碼範例是針對 類別提供的較大範例的 SqlDataSourceStatusEventArgs 一部分。

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId" />
      <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId" />
      <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>

備註

屬性 QueryStringField 會識別以查詢字串傳遞的名稱/值組。 屬性 QueryStringField 會識別配對的名稱，而 QueryStringParameter 屬性則會在執行時間系結至其對應的值。 如果預期的查詢字串名稱/值組未傳遞至含有查詢字串的頁面， Evaluate 方法會嘗試將 參數系結至 屬性的值 DefaultValue 。 DefaultValue如果未設定屬性， Evaluate 方法就無法將參數系結至值。