QueryStringParameter.QueryStringField Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

Obtiene o establece el nombre del campo de cadena de consulta al que se enlaza el parámetro.

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

String

Nombre del campo de cadena de consulta al que se enlaza el parámetro.

Ejemplos

En el ejemplo siguiente se muestra cómo usar un QueryStringParameter objeto junto con un SqlDataSource control para mostrar datos en un 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. Se proporciona una DefaultValue propiedad en caso de que el par nombre-valor no se pase con la cadena de consulta.

      <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 usar un QueryStringParameter objeto junto con un SqlDataSource control para mostrar datos en un GridView control . El QueryStringParameter objeto se agrega a la SelectParameters colección, junto con otros objetos de parámetro que se usan para el parámetro de salida y el valor devuelto. Para recuperar datos, controle los valores que se devuelven del procedimiento almacenado. Este ejemplo de código forma parte de un ejemplo más grande que se proporciona para la SqlDataSourceStatusEventArgs clase .

<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 nombre-valor que se pasa con la cadena de consulta. La QueryStringField propiedad identifica el nombre del par, mientras que la QueryStringParameter propiedad se enlaza a su valor correspondiente en tiempo de ejecución. Si el par nombre/valor de cadena de consulta esperado no se pasa a la página con la cadena de consulta, el Evaluate método intenta enlazar el parámetro al valor de la DefaultValue propiedad . Si la DefaultValue propiedad no está establecida, el Evaluate método no puede enlazar el parámetro a un valor.