RouteParameter Classe
Definição
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 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
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 @productname
de consulta . O valor do parâmetro culture
url de rota é passado para o parâmetro @culture
de consulta . Se uma URL de rota não incluir o parâmetro culture
de 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 |
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) |