QueryStringParameter Classe

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.

Associa o valor de um campo de cadeia de caracteres de consulta de solicitação HTTP a um objeto de parâmetro.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

Herança: Object

Parameter
QueryStringParameter

Exemplos

O exemplo a seguir mostra como criar um objeto QueryStringParameter a ser usado como um filtro ao exibir dados em um controle GridView. Adicione o objeto QueryStringParameter à coleção de FilterParameters do controle AccessDataSource. O objeto de parâmetro associa o valor do campo de cadeia de caracteres de consulta denominado country à cadeia de caracteres FilterExpression. Como nenhuma propriedade DefaultValue é especificada para o parâmetro, se nenhum campo chamado country for passado com a cadeia de caracteres de consulta, o controle AccessDataSource gerará uma exceção NullReferenceException. Se um campo chamado country for passado, mas não tiver valor, o controle GridView não exibirá dados.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </form>
  </body>
</html>

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

    </form>
  </body>
</html>

Comentários

Você pode usar a classe QueryStringParameter para associar o valor de um campo que é passado como parte de uma cadeia de consulta de solicitação HTTP a um parâmetro usado em uma consulta ou comando parametrizado. O campo é recuperado da coleção QueryString.

Controles que associam dados ao parâmetro podem gerar uma exceção se um objeto QueryStringParameter for referenciado, mas nenhum par de nome/valor de cadeia de consulta correspondente for passado. Da mesma forma, eles podem não exibir dados se o nome do campo de cadeia de caracteres de consulta for passado sem um valor correspondente. Para evitar essas situações, defina a propriedade DefaultValue quando apropriado.

A classe QueryStringParameter fornece a propriedade QueryStringField, que identifica o nome do valor da cadeia de caracteres de consulta à qual associar. Ele também fornece as propriedades herdadas da classe Parameter.

Importante

A classe QueryStringParameter não valida o valor passado; ele fornece o valor bruto. No entanto, você pode validar o valor de um objeto QueryStringParameter em um controle de fonte de dados. Para fazer isso, manipule o evento Selecting, Updating, Insertingou Deleting do controle da fonte de dados e verifique o valor do parâmetro no manipulador de eventos. Se o valor do parâmetro não passar nos testes de validação, você poderá cancelar a operação de dados definindo a propriedade Cancel da classe CancelEventArgs associada como true.

Construtores

QueryStringParameter()	Inicializa uma nova instância sem nome da classe QueryStringParameter.
QueryStringParameter(QueryStringParameter)	Inicializa uma nova instância da classe QueryStringParameter, usando os valores da instância especificados pelo parâmetro `original`.
QueryStringParameter(String, DbType, String)	Inicializa uma nova instância nomeada da classe QueryStringParameter, usando o campo de cadeia de caracteres de consulta especificado e o tipo de dados do parâmetro.
QueryStringParameter(String, String)	Inicializa uma nova instância nomeada da classe QueryStringParameter, usando a cadeia de caracteres especificada para identificar a qual campo de cadeia de caracteres de consulta associar.
QueryStringParameter(String, TypeCode, String)	Inicializa uma nova instância nomeada e fortemente tipada da classe QueryStringParameter, usando a cadeia de caracteres especificada para identificar a qual campo de cadeia de caracteres de consulta deve ser associado.

Propriedades

ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o objeto Parameter está associado deve ser convertido em `null` se for Empty. (Herdado de Parameter)
DbType	Obtém ou define o tipo de banco de dados do parâmetro. (Herdado de Parameter)
DefaultValue	Especifica um valor padrão para o parâmetro, caso o valor que o parâmetro esteja associado seja não inicializado quando o método Evaluate(HttpContext, Control) for chamado. (Herdado de Parameter)
Direction	Indica se o objeto Parameter é usado para associar um valor a um controle ou se o controle pode ser usado para alterar o valor. (Herdado de Parameter)
IsTrackingViewState	Obtém um valor que indica se o objeto Parameter está salvando alterações em seu estado de exibição. (Herdado de Parameter)
Name	Obtém ou define o nome do parâmetro. (Herdado de Parameter)
QueryStringField	Obtém ou define o nome do campo cadeia de caracteres de consulta ao qual o parâmetro se associa.
Size	Obtém ou define o tamanho do parâmetro. (Herdado de Parameter)
Type	Obtém ou define o tipo do parâmetro. (Herdado de Parameter)
ValidateInput	Obtém ou define se o valor do parâmetro de cadeia de caracteres de consulta está sendo validado ou não.
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto Parameter em várias solicitações para a mesma página. (Herdado de Parameter)

Métodos

Clone()	Retorna uma duplicata da instância de QueryStringParameter atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Evaluate(HttpContext, Control)	Atualiza e retorna o valor do objeto QueryStringParameter.
GetDatabaseType()	Obtém o valor DbType equivalente ao tipo CLR da instância de Parameter atual. (Herdado de Parameter)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados. (Herdado de Parameter)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnParameterChanged()	Chama o método OnParametersChanged(EventArgs) da coleção ParameterCollection que contém o objeto Parameter. (Herdado de Parameter)
SaveViewState()	Salva as alterações no estado de exibição do objeto Parameter desde o momento em que a página foi postada de volta no servidor. (Herdado de Parameter)
SetDirty()	Marca o objeto Parameter para que seu estado seja registrado no estado de exibição. (Herdado de Parameter)
ToString()	Converte o valor dessa instância em sua representação de cadeia de caracteres equivalente. (Herdado de Parameter)
TrackViewState()	Faz com que o objeto Parameter acompanhe as alterações em seu estado de exibição para que possam ser armazenadas no objeto ViewState do controle e mantidas entre solicitações para a mesma página. (Herdado de Parameter)

Implantações explícitas de interface

ICloneable.Clone()	Retorna uma duplicata da instância de Parameter atual. (Herdado de Parameter)
IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto Parameter está salvando alterações em seu estado de exibição. (Herdado de Parameter)
IStateManager.LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados. (Herdado de Parameter)
IStateManager.SaveViewState()	Salva as alterações no estado de exibição do objeto Parameter desde o momento em que a página foi postada de volta no servidor. (Herdado de Parameter)
IStateManager.TrackViewState()	Faz com que o objeto Parameter acompanhe as alterações em seu estado de exibição para que possam ser armazenadas no objeto ViewState do controle e mantidas entre solicitações para a mesma página. (Herdado de Parameter)

Aplica-se a

Partilhar via