QueryStringParameter.QueryStringField Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o nome do campo da cadeia de caracteres de consulta ao qual o parâmetro está associado.

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

String

O nome do campo da cadeia de caracteres de consulta ao qual o parâmetro está associado.

Exemplos

O exemplo a seguir mostra como usar um QueryStringParameter objeto junto com um SqlDataSource controle para exibir dados em um ListBox controle. A QueryStringField propriedade é definida como o nome do campo de cadeia de caracteres de consulta esperado e o parâmetro é adicionado à SelectParameters coleção. Uma DefaultValue propriedade é fornecida caso o par nome/valor não seja passado com a cadeia de caracteres 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>

O exemplo a seguir mostra como usar um QueryStringParameter objeto junto com um SqlDataSource controle para exibir dados em um GridView controle. O QueryStringParameter objeto é adicionado à SelectParameters coleção, juntamente com outros objetos de parâmetro que são usados para o parâmetro de saída e o valor retornado. Para recuperar dados, manipule os valores retornados do procedimento armazenado. Este exemplo de código faz parte de um exemplo maior fornecido para a 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>

Comentários

A QueryStringField propriedade identifica um par nome/valor que é passado com a cadeia de caracteres de consulta. A QueryStringField propriedade identifica o nome do par, enquanto a QueryStringParameter propriedade é associada ao valor correspondente em tempo de execução. Se o par nome/valor de cadeia de consulta/valor esperado não for passado para a página com a cadeia de caracteres de consulta, o Evaluate método tentará associar o parâmetro ao valor da DefaultValue propriedade. Se a DefaultValue propriedade não estiver definida, o Evaluate método não associará o parâmetro a um valor.

Aplica-se a

Partilhar via