QueryStringParameter.QueryStringField Eigenschap

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

Waarde van eigenschap

De naam van het querytekenreeksveld waaraan de parameter is gekoppeld.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een QueryStringParameter object samen met een SqlDataSource besturingselement gebruikt om gegevens in een ListBox besturingselement weer te geven. De QueryStringField eigenschap is ingesteld op de naam van het verwachte querytekenreeksveld en de parameter wordt toegevoegd aan de SelectParameters verzameling. Er wordt een DefaultValue eigenschap opgegeven als het naam-/waardepaar niet wordt doorgegeven met de querytekenreeks.

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

In het volgende voorbeeld ziet u hoe u een QueryStringParameter object samen met een SqlDataSource besturingselement gebruikt om gegevens in een GridView besturingselement weer te geven. Het QueryStringParameter object wordt toegevoegd aan de SelectParameters verzameling, samen met andere parameterobjecten die worden gebruikt voor de uitvoerparameter en retourwaarde. Als u gegevens wilt ophalen, moet u de waarden verwerken die worden geretourneerd uit de opgeslagen procedure. Dit codevoorbeeld maakt deel uit van een groter voorbeeld dat is opgegeven voor de SqlDataSourceStatusEventArgs klasse.

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

Opmerkingen

De QueryStringField eigenschap identificeert een naam/waardepaar dat wordt doorgegeven met de querytekenreeks. De QueryStringField eigenschap identificeert de naam van het paar, terwijl de eigenschap tijdens runtime wordt gekoppeld aan de QueryStringParameter bijbehorende waarde. Als het verwachte naam-/waardepaar van de queryreeks niet wordt doorgegeven aan de pagina met de querytekenreeks, probeert de methode de Evaluate parameter te binden aan de waarde van de DefaultValue eigenschap. Als de DefaultValue eigenschap niet is ingesteld, kan de Evaluate methode de parameter niet binden aan een waarde.