QueryStringParameter.QueryStringField Proprietà

Definizione

Ottiene o imposta il nome del campo della stringa di query a cui è associato il parametro.

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

Valore della proprietà

String

Nome del campo della stringa di query a cui è associato il parametro.

Esempio

Nell'esempio seguente viene illustrato come utilizzare un QueryStringParameter oggetto insieme a un SqlDataSource controllo per visualizzare i dati in un ListBox controllo . La QueryStringField proprietà viene impostata sul nome del campo della stringa di query prevista e il parametro viene aggiunto alla SelectParameters raccolta. Viene fornita una DefaultValue proprietà nel caso in cui la coppia nome/valore non venga passata con la stringa di query.

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

Nell'esempio seguente viene illustrato come utilizzare un QueryStringParameter oggetto insieme a un SqlDataSource controllo per visualizzare i dati in un GridView controllo . L'oggetto QueryStringParameter viene aggiunto all'insieme SelectParameters , insieme ad altri oggetti parametro utilizzati per il parametro di output e il valore restituito. Per recuperare i dati, gestire i valori restituiti dalla stored procedure. Questo esempio di codice fa parte di un esempio più ampio fornito per la SqlDataSourceStatusEventArgs classe .

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

Commenti

La QueryStringField proprietà identifica una coppia nome/valore passata con la stringa di query. La QueryStringField proprietà identifica il nome della coppia, mentre la QueryStringParameter proprietà viene associata al valore corrispondente in fase di esecuzione. Se la coppia nome/valore della stringa di query prevista non viene passata alla pagina con la stringa di query, il Evaluate metodo tenta di associare il parametro al valore della DefaultValue proprietà. Se la DefaultValue proprietà non è impostata, il Evaluate metodo non riesce a associare il parametro a un valore.

Si applica a