QueryStringParameter Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Vincula o valor de um campo de sequência de consulta de pedido 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 seguinte mostra como criar um QueryStringParameter objeto para usar como filtro quando apresenta dados num GridView controlo. Adiciona-se o QueryStringParameter objeto à AccessDataSource coleção do FilterParameters controlo. O objeto parâmetro associa o valor do campo de sequência de consulta nomeado country à sua FilterExpression cadeia. Como nenhuma DefaultValue propriedade é especificada para o parâmetro, se nenhum campo nomeado country for passado com a cadeia de consulta, o AccessDataSource controlo lança uma NullReferenceException exceção. Se um campo nomeado country for passado mas não tiver valor, o controlo GridView não apresenta 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>

Observações

Pode usar a QueryStringParameter classe para associar o valor de um campo que é passado como parte de uma cadeia de consulta de pedido HTTP a um parâmetro usado numa consulta ou comando parametrizado. O campo foi retirado da QueryString coleção.

Controlos que associam dados ao parâmetro podem lançar uma exceção se um QueryStringParameter objeto for referenciado, mas nenhum par nome/valor correspondente é passado. De forma semelhante, podem não mostrar dados se o nome do campo da sequência de consulta for passado sem um valor correspondente. Para evitar estas situações, coloque a DefaultValue propriedade onde for apropriado.

A QueryStringParameter classe fornece a QueryStringField propriedade que identifica o nome do valor da string de consulta a que se deve ligar. Também fornece as propriedades herdadas da Parameter classe.

Importante

A QueryStringParameter classe não valida o valor que é passado; fornece o valor bruto. No entanto, pode validar o valor de um QueryStringParameter objeto num controlo de fonte de dados. Para tal, trata o Selecting, Updating, Inserting, ou Deleting o evento do controlo de fonte de dados e verifica o valor do parâmetro no gestor de eventos. Se o valor do parâmetro não passar nos testes de validação, pode cancelar a operação de dados definindo a Cancel propriedade da classe associada CancelEventArgs para true.

Construtores

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

Propriedades

Name	Description
ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está ligado deve ser convertido se `null` for Empty. (Herdado de Parameter)
DbType	Obtém ou define o tipo de base de dados do parâmetro. (Herdado de Parameter)
DefaultValue	Especifica um valor por defeito para o parâmetro, caso o valor que o parâmetro está vinculado a ser 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 controlo, ou se o controlo pode ser usado para alterar o valor. (Herdado de Parameter)
IsTrackingViewState	Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização. (Herdado de Parameter)
Name	Obtém ou define o nome do parâmetro. (Herdado de Parameter)
QueryStringField	Recebe ou define o nome do campo de sequência de consulta ao qual o parâmetro se liga.
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 da cadeia de consulta está a ser validado ou não.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um Parameter objeto através de múltiplos pedidos para a mesma página. (Herdado de Parameter)

Métodos

Name	Description
Clone()	Devolve um duplicado da instância atual QueryStringParameter .
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Evaluate(HttpContext, Control)	Atualiza e devolve 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 função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de Parameter)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnParameterChanged()	Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto. (Herdado de Parameter)
SaveViewState()	Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de Parameter)
SetDirty()	Marca o Parameter objeto para que o seu estado fique registado no estado de visualização. (Herdado de Parameter)
ToString()	Converte o valor desta instância para a sua representação equivalente da cadeia. (Herdado de Parameter)
TrackViewState()	Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página. (Herdado de Parameter)

Implementações de Interface Explícita

Name	Description
ICloneable.Clone()	Devolve um duplicado da instância atual Parameter . (Herdado de Parameter)
IStateManager.IsTrackingViewState	Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização. (Herdado de Parameter)
IStateManager.LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de Parameter)
IStateManager.SaveViewState()	Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de Parameter)
IStateManager.TrackViewState()	Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página. (Herdado de Parameter)

Aplica-se a

Ver também

Comentários

Esta página foi útil?