Route Classe

Definição

Fornece propriedades e métodos para definir uma rota e para obter informações sobre ela.Provides properties and methods for defining a route and for obtaining information about the route.

public ref class Route : System::Web::Routing::RouteBase
public class Route : System.Web.Routing.RouteBase
type Route = class
    inherit RouteBase
Public Class Route
Inherits RouteBase
Herança
Derivado

Exemplos

O exemplo a seguir mostra como criar um objeto Route e adicioná-lo à propriedade Routes.The following example shows how to create a Route object and add it to the Routes property.

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    routes.Add(new Route
    (
         "Category/{action}/{categoryName}"
         , new CategoryRouteHandler()
    ));
}
Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
    Dim urlPattern As String
    Dim categoryRoute As Route
    
    urlPattern = "Category/{action}/{categoryName}"
    
    categoryRoute = New Route(urlPattern, New CategoryRouteHandler)
    
    routes.Add(categoryRoute)
End Sub

Comentários

A classe Route permite que você especifique como o roteamento é processado em um aplicativo ASP.NET.The Route class enables you to specify how routing is processed in an ASP.NET application. Você cria um objeto Route para cada padrão de URL que você deseja mapear para uma classe que pode manipular solicitações que correspondem a esse padrão.You create a Route object for each URL pattern that you want to map to a class that can handle requests that correspond to that pattern. Em seguida, você adiciona a rota à coleção de Routes.You then add the route to the Routes collection. Quando o aplicativo recebe uma solicitação, o roteamento de ASP.NET itera através das rotas na coleção de Routes para localizar a primeira rota que corresponde ao padrão da URL.When the application receives a request, ASP.NET routing iterates through the routes in the Routes collection to find the first route that matches the pattern of the URL.

Defina a propriedade Url como um padrão de URL.Set the Url property to a URL pattern. O padrão de URL consiste em segmentos que vêm após o nome do aplicativo em uma solicitação HTTP.The URL pattern consists of segments that come after the application name in an HTTP request. Por exemplo, na URL http://www.contoso.com/products/show/beverages, o padrão aplica-se a products/show/beverages.For example, in the URL http://www.contoso.com/products/show/beverages, the pattern applies to products/show/beverages. Um padrão com três segmentos, como {controller}/{action}/{id}, corresponde à URL http://www.contoso.com/products/show/beverages.A pattern with three segments, such as {controller}/{action}/{id}, matches the URL http://www.contoso.com/products/show/beverages. Cada segmento é delimitado pelo caractere de /.Each segment is delimited by the / character. Quando um segmento é colocado entre chaves ({ e }), o segmento é referenciado em um parâmetro de URL.When a segment is enclosed in braces ({ and }), the segment is referred to a URL parameter. O roteamento de ASP.NET recupera o valor da solicitação e o atribui ao parâmetro de URL.ASP.NET routing retrieves the value from the request and assigns it to the URL parameter. No exemplo anterior, o parâmetro de URL action é atribuído ao valor show.In the previous example, the URL parameter action is assigned the value show. Se o segmento não estiver entre chaves, o valor será tratado como um valor literal.If the segment is not enclosed in braces, the value is treated as a literal value.

Defina a propriedade Defaults como um objeto RouteValueDictionary que inclui valores que serão usados se um parâmetro estiver ausente da URL ou para definir valores adicionais que não são parametrizados na URL.Set the Defaults property to a RouteValueDictionary object that includes values that are used if a parameter is missing from the URL or to set additional values that are not parameterized in the URL. Defina a propriedade Constraints como um objeto RouteValueDictionary que contém valores que são expressões regulares ou objetos IRouteConstraint.Set the Constraints property to a RouteValueDictionary object that contains values that are either regular expressions or IRouteConstraint objects. Esses valores são usados para determinar se um valor de parâmetro é válido.These values are used to determine whether a parameter value is valid.

Construtores

Route(String, IRouteHandler)

Inicializa uma nova instância da classe Route usando o padrão de URL e a classe de manipulador especificados.Initializes a new instance of the Route class, by using the specified URL pattern and handler class.

Route(String, RouteValueDictionary, IRouteHandler)

Inicializa uma nova instância da classe Route usando o padrão de URL, a classe de manipulador e os valores de parâmetro padrão especificados.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, and handler class.

Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Inicializa uma nova instância da classe Route usando o padrão de URL, as restrições, a classe de manipulador e os valores de parâmetro padrão especificados.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, and handler class.

Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Inicializa uma nova instância da classe Route usando o padrão de URL, os valores de parâmetro padrão, as restrições, a classe de manipulador e os valores personalizados especificados.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, custom values, and handler class.

Propriedades

Constraints

Obtém ou define um dicionário de expressões que especificam os valores válidos para um parâmetro de URL.Gets or sets a dictionary of expressions that specify valid values for a URL parameter.

DataTokens

Obtém ou define valores personalizados que são passados para o manipulador de rotas, mas que não são usados para determinar se a rota corresponde a um padrão de URL.Gets or sets custom values that are passed to the route handler, but which are not used to determine whether the route matches a URL pattern.

Defaults

Obtém ou define os valores a serem usados se a URL não contiver todos os parâmetros.Gets or sets the values to use if the URL does not contain all the parameters.

RouteExistingFiles

Obtém ou define um valor que indica se o roteamento do ASP.NET deve tratar URLs que correspondam a um arquivo existente.Gets or sets a value that indicates whether ASP.NET routing should handle URLs that match an existing file.

(Herdado de RouteBase)
RouteHandler

Obtém ou define o objeto que processa as solicitações para a rota.Gets or sets the object that processes requests for the route.

Url

Obtém ou define o padrão de URL para a rota.Gets or sets the URL pattern for the route.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetRouteData(HttpContextBase)

Retorna informações sobre a rota solicitada.Returns information about the requested route.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetVirtualPath(RequestContext, RouteValueDictionary)

Retorna informações sobre a URL que está associada com a rota.Returns information about the URL that is associated with the route.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)

Determina se um valor de parâmetro corresponde à restrição para esse parâmetro.Determines whether a parameter value matches the constraint for that parameter.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também