QueryStringParameter.QueryStringField Egenskap

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

Egenskapsvärde

Namnet på det frågesträngsfält som parametern binder till.

Exempel

I följande exempel visas hur du använder ett QueryStringParameter objekt tillsammans med en SqlDataSource kontroll för att visa data i en ListBox kontroll. Egenskapen QueryStringField är inställd på namnet på det förväntade frågesträngsfältet och parametern läggs till i SelectParameters samlingen. En DefaultValue egenskap tillhandahålls om namn/värde-paret inte skickas med frågesträngen.

      <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>

I följande exempel visas hur du använder ett QueryStringParameter objekt tillsammans med en SqlDataSource kontroll för att visa data i en GridView kontroll. Objektet QueryStringParameter läggs till i SelectParameters samlingen tillsammans med andra parameterobjekt som används för utdataparametern och returvärdet. Om du vill hämta data hanterar du de värden som returneras från den lagrade proceduren. Det här kodexemplet är en del av ett större exempel som tillhandahålls SqlDataSourceStatusEventArgs för klassen.

<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>

Kommentarer

Egenskapen QueryStringField identifierar ett namn/värde-par som skickas med frågesträngen. Egenskapen QueryStringField identifierar namnet på paret, medan QueryStringParameter egenskapen binder till motsvarande värde vid körning. Om det förväntade frågesträngsnamnet/värdeparet inte skickas till sidan med frågesträngen Evaluate försöker metoden sedan binda parametern till värdet för DefaultValue egenskapen. Om egenskapen DefaultValue inte har angetts Evaluate kan metoden inte binda parametern till ett värde.