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

参数所绑定的查询字符串字段的名称。

示例

以下示例演示如何将 QueryStringParameter 对象与控件一 SqlDataSource 起使用以显示控件中的数据 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>

以下示例演示如何将 QueryStringParameter 对象与控件一 SqlDataSource 起使用以显示控件中的数据 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 将无法将参数绑定到值。