RouteParameter Classe

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Associa o valor de um segmento de URL a um objeto de parâmetro.

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

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

type RouteParameter = class
    inherit Parameter

Public Class RouteParameter
Inherits Parameter

Herança

Object

Parameter

RouteParameter

Exemplos

Os exemplos nesta seção mostram como usar RouteParameter objetos na marcação para passar valores de parâmetro de URL para uma consulta especificada para um controle de fonte de dados.

O exemplo a seguir mostra o código na página Global.asax que define uma rota chamada ProductRoute. A rota define um parâmetro de URL chamado productname. A rota também define um parâmetro catchall opcional chamado culture, que pode ser usado para especificar o idioma no qual a descrição do produto é exibida. A página Product.aspx manipula solicitações para essa rota.

O exemplo a seguir mostra a página Product.aspx. A página contém um SqlDataSource controle que tem uma consulta que requer dois parâmetros, um para o nome do produto e outro para o idioma da descrição do produto. RouteParameter os objetos são usados para fornecer os valores para os parâmetros de consulta. O valor do parâmetro productname url de rota é passado para o parâmetro @productnamede consulta . O valor do parâmetro culture url de rota é passado para o parâmetro @culturede consulta . Se uma URL de rota não incluir o parâmetro culturede URL , um valor padrão de "en" será usado.

O exemplo a seguir mostra uma página chamada ProductLinks.aspx, que contém hiperlinks que se vinculam à página Product.aspx usando URLs de rota. Esses hiperlinks usam RouteUrl expressões para criar URLs de rota. O primeiro link não inclui um culture parâmetro de rota. Portanto, o valor padrão de "en" definido no objeto para @culture o RouteParameter parâmetro de consulta será usado na consulta. O segundo link fornece um culture valor de "fr", que faz com que a descrição seja exibida em francês. Para obter mais informações sobre como usar RouteUrl expressões, consulte Como construir URLs de rotas.

Ao clicar no primeiro hiperlink, você verá a página Product.aspx com os seguintes valores no GridView controle :

ProductID	Nome	Descrição
994	LL Bottom Bracket	Chromoly steel.

Ao clicar no segundo hiperlink, você verá os seguintes valores no GridView controle :

ProductID	Nome	Descrição
994	LL Bottom Bracket	Acier chromé.

Para executar este exemplo, adicione as duas páginas .aspx e o código no arquivo Global.asax a um site de ASP.NET ou aplicativo Web que define uma cadeia de conexão chamada AdventureWorksLTConnectionString para o banco de dados AdventureWorksLT. Para obter informações sobre como configurar uma conexão com o banco de dados AdventureWorksLT, consulte Como configurar um banco de dados de exemplo AdventureWorksLT para desenvolvimento de ASP.NET.

Para obter mais informações sobre ASP.NET roteamento, consulte Roteamento ASP.NET.

Comentários

Se você implementar ASP.NET roteamento em um site da Web, poderá usar o RouteParameter objeto para associar o valor de um segmento da URL solicitada a uma consulta ou comando de banco de dados. Você pode declarar RouteParameter objetos na marcação para controles de fonte de dados ou o QueryExtender controle .

Um projeto de site do Visual Studio com código-fonte está disponível para acompanhar este tópico: Baixar.

Construtores

RouteParameter()	Inicializa uma nova instância da classe RouteParameter.
RouteParameter(RouteParameter)	Inicializa uma nova instância da classe RouteParameter usando os valores da instância especificada.
RouteParameter(String, DbType, String)	Inicializa uma nova instância da classe RouteParameter usando o nome e o tipo de banco de dados especificados para o parâmetro, além de usar os dados especificados para os dados de rota.
RouteParameter(String, String)	Inicializa uma nova instância da classe RouteParameter usando o nome especificado para o parâmetro e a chave especificada para os dados de rota.
RouteParameter(String, TypeCode, String)	Inicializa uma nova instância da classe RouteParameter usando o nome e tipo especificados para o parâmetro, além de usar os dados especificados para os dados de rota.

Propriedades

ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o objeto Parameter está associado deverá ser convertido em null se ele 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 a que o parâmetro esteja associado não devesse ser 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 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 no estado de exibição. (Herdado de Parameter)
Name	Obtém ou define o nome do parâmetro. (Herdado de Parameter)
RouteKey	Obtém ou define o nome do segmento de rota do qual recuperar o valor para o parâmetro de rota.
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)
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 da mesma página. (Herdado de Parameter)

Métodos

Clone()	Retorna uma duplicata da instância de RouteParameter atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Evaluate(HttpContext, Control)	Avalia a URL da solicitação e retorna o valor do parâmetro.
GetDatabaseType()	Obtém o valor DbType que é equivalente ao tipo CLR da instância 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 de fonte de dados. (Herdado de Parameter)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (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 ao estado de exibição do objeto Parameter desde a hora em que a página foi postada de volta no servidor. (Herdado de Parameter)
SetDirty()	Marca o objeto Parameter de modo que seu estado seja registrado no estado de exibição. (Herdado de Parameter)
ToString()	Converte o valor dessa instância na representação da cadeia de caracteres equivalente. (Herdado de Parameter)
TrackViewState()	Faz com que o objeto Parameter controle as alterações a seu estado de exibição de modo que elas possam ser armazenadas no objeto ViewState do controle e persistidas 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 no estado de exibição. (Herdado de Parameter)
IStateManager.LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados. (Herdado de Parameter)
IStateManager.SaveViewState()	Salva as alterações ao estado de exibição do objeto Parameter desde a hora em que a página foi postada de volta no servidor. (Herdado de Parameter)
IStateManager.TrackViewState()	Faz com que o objeto Parameter controle as alterações a seu estado de exibição de modo que elas possam ser armazenadas no objeto ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de Parameter)

Confira também

• QueryExtender
• Visão geral do controle do servidor Web QueryExtender