QueryStringParameter.QueryStringField Propiedad

Definición

Obtiene o establece el nombre del campo de cadena de consulta al que se enlaza el parámetro.Gets or sets the name of the query-string field that the parameter binds to.

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

Valor de propiedad

Nombre del campo de cadena de consulta al que se enlaza el parámetro.The name of the query-string field that the parameter binds to.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar QueryStringParameter un objeto junto con SqlDataSource un control para Mostrar datos en ListBox un control.The following example shows how to use a QueryStringParameter object together with a SqlDataSource control to display data in a ListBox control. La QueryStringField propiedad se establece en el nombre del campo de cadena de consulta esperado y el parámetro se agrega a la SelectParameters colección.The QueryStringField property is set to the name of the expected query-string field, and the parameter is added to the SelectParameters collection. Se DefaultValue proporciona una propiedad en caso de que el par de nombre y valor no se pase con la cadena de consulta.A DefaultValue property is provided in case the name/value pair is not passed with the query string.

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

En el ejemplo siguiente se muestra cómo utilizar QueryStringParameter un objeto junto con SqlDataSource un control para Mostrar datos en GridView un control.The following example shows how to use a QueryStringParameter object together with a SqlDataSource control to display data in a GridView control. El QueryStringParameter objeto se agrega a la SelectParameters colección, junto con otros objetos de parámetro que se utilizan para el parámetro de salida y el valor devuelto.The QueryStringParameter object is added to the SelectParameters collection, together with other parameter objects that are used for the output parameter and return value. Para recuperar datos, controle los valores devueltos por el procedimiento almacenado.To retrieve data, handle the values that are returned from the stored procedure. Este ejemplo de código forma parte de un ejemplo más grande que se proporciona SqlDataSourceStatusEventArgs para la clase.This code example is part of a larger example that is provided for the SqlDataSourceStatusEventArgs class.

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

Comentarios

La QueryStringField propiedad identifica un par de nombre y valor que se pasa con la cadena de consulta.The QueryStringField property identifies a name/value pair that is passed with the query string. La QueryStringField propiedad identifica el nombre del par, mientras que la QueryStringParameter propiedad se enlaza a su valor correspondiente en tiempo de ejecución.The QueryStringField property identifies the name of the pair, whereas the QueryStringParameter property binds to its corresponding value at run time. Si el par de nombre y valor de la cadena de consulta esperada no se pasa a la página con la Evaluate cadena de consulta, el método intenta enlazar el parámetro al DefaultValue valor de la propiedad.If the expected query-string name/value pair is not passed to the page with the query string, the Evaluate method then tries to bind the parameter to the value of the DefaultValue property. Si no DefaultValue se establece la propiedad, el Evaluate método no puede enlazar el parámetro a un valor.If the DefaultValue property is not set, the Evaluate method fails to bind the parameter to a value.

Se aplica a