QueryStringParameter Classe

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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 AccessDataSource do controle FilterParameters. 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

Nome Description
QueryStringParameter()

Inicializa uma nova instância sem nome da QueryStringParameter classe.
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

Nome Description
ConvertEmptyStringToNull

Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está associado deve ser convertido 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 Evaluate(HttpContext, Control) método for chamado.

(Herdado de Parameter)
Direction

Indica se o Parameter objeto é 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 Parameter objeto 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 Parameter objeto em várias solicitações para a mesma página.

(Herdado de Parameter)

Métodos

Nome Description
Clone()

Retorna uma duplicata da instância atual QueryStringParameter .
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Evaluate(HttpContext, Control)

Atualiza e retorna o valor do QueryStringParameter objeto.
GetDatabaseType()

Obtém o DbType valor equivalente ao tipo CLR da instância atual Parameter .

(Herdado de Parameter)
GetHashCode()

Serve como a função hash predefinida.

(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 OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto.

(Herdado de Parameter)
SaveViewState()

Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor.

(Herdado de Parameter)
SetDirty()

Marca o Parameter objeto 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 Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página.

(Herdado de Parameter)

Implantações explícitas de interface

Nome Description
ICloneable.Clone()

Retorna uma duplicata da instância atual Parameter .

(Herdado de Parameter)
IStateManager.IsTrackingViewState

Obtém um valor que indica se o Parameter objeto 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 Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor.

(Herdado de Parameter)
IStateManager.TrackViewState()

Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página.

(Herdado de Parameter)

Aplica-se a

Confira também