QueryStringParameter.QueryStringField Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Namen des Abfragezeichenfolgenfelds ab, an das der Parameter gebunden wird, oder legt diesen fest.

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

Eigenschaftswert

String

Der Name des Abfragezeichenfolgenfelds, an das der Parameter gebunden wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie ein QueryStringParameter Objekt zusammen mit einem SqlDataSource Steuerelement verwenden, um Daten in einem ListBox Steuerelement anzuzeigen. Die QueryStringField Eigenschaft wird auf den Namen des erwarteten Abfragezeichenfolgenfelds festgelegt, und der Parameter wird der SelectParameters Auflistung hinzugefügt. Eine DefaultValue Eigenschaft wird bereitgestellt, wenn das Name/Wert-Paar nicht mit der Abfragezeichenfolge übergeben wird.

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

Das folgende Beispiel zeigt, wie Sie ein QueryStringParameter Objekt zusammen mit einem SqlDataSource Steuerelement verwenden, um Daten in einem GridView Steuerelement anzuzeigen. Das QueryStringParameter Objekt wird der SelectParameters Auflistung zusammen mit anderen Parameterobjekten hinzugefügt, die für den Ausgabeparameter und rückgabewert verwendet werden. Um Daten abzurufen, behandeln Sie die Werte, die aus der gespeicherten Prozedur zurückgegeben werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SqlDataSourceStatusEventArgs Klasse bereitgestellt wird.

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

Hinweise

Die QueryStringField Eigenschaft identifiziert ein Name/Wert-Paar, das mit der Abfragezeichenfolge übergeben wird. Die QueryStringField Eigenschaft identifiziert den Namen des Paares, während die QueryStringParameter Eigenschaft zur Laufzeit an den entsprechenden Wert gebunden wird. Wenn das erwartete Abfragezeichenfolgennamen/Wertpaar nicht an die Seite mit der Abfragezeichenfolge übergeben wird, versucht die Evaluate Methode, den Parameter an den Wert der DefaultValue Eigenschaft zu binden. Wenn die Eigenschaft nicht festgelegt ist, kann die DefaultValue Evaluate Methode den Parameter nicht an einen Wert binden.

Gilt für

Freigeben über