Route Classe

Definizione

Spazio dei nomi:

System.Web.Routing

Assembly:

System.Web.dll

Fornisce proprietà e metodi per definire una route e per ottenere informazioni sulla 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

Ereditarietà

Object

RouteBase

Route

Derivato

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Esempio

Nell'esempio Routes seguente viene illustrato come creare un Route oggetto e aggiungerlo alla proprietà.

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

Commenti

La Route classe consente di specificare il modo in cui il routing viene elaborato in un'applicazione ASP.NET. Si crea un Route oggetto per ogni modello URL che si vuole eseguire il mapping a una classe che può gestire le richieste corrispondenti a tale modello. Si aggiunge quindi la route alla Routes raccolta. Quando l'applicazione riceve una richiesta, ASP.NET il routing esegue l'iterazione delle route nella Routes raccolta per trovare la prima route corrispondente al modello dell'URL.

Impostare la Url proprietà su un modello URL. Il modello URL è costituito da segmenti che vengono dopo il nome dell'applicazione in una richiesta HTTP. Ad esempio, nell'URL http://www.contoso.com/products/show/beverages, il modello si applica a products/show/beverages. Modello con tre segmenti, ad esempio {controller}/{action}/{id}, corrisponde all'URL http://www.contoso.com/products/show/beverages. Ogni segmento è delimitato dal / carattere. Quando un segmento è racchiuso tra parentesi graffe ({ e }), il segmento viene fatto riferimento a un parametro URL. ASP.NET routing recupera il valore dalla richiesta e lo assegna al parametro URL. Nell'esempio precedente il parametro action URL viene assegnato al valore show. Se il segmento non è racchiuso tra parentesi graffe, il valore viene considerato come valore letterale.

Impostare la Defaults proprietà su un RouteValueDictionary oggetto che include valori usati se un parametro non è presente nell'URL o impostare valori aggiuntivi non parametrizzati nell'URL. Impostare la Constraints proprietà su un RouteValueDictionary oggetto contenente valori che sono espressioni regolari o IRouteConstraint oggetti. Questi valori vengono usati per determinare se un valore di parametro è valido.

Costruttori

Route(String, IRouteHandler)	Inizializza una nuova istanza della classe Route usando il modello di URL e la classe del gestore specificati.
Route(String, RouteValueDictionary, IRouteHandler)	Inizializza una nuova istanza della classe Route usando il modello di URL, i valori dei parametri predefiniti e la classe del gestore specificati.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inizializza una nuova istanza della classe Route usando il modello di URL, i valori dei parametri predefiniti, i vincoli e la classe del gestore specificati.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inizializza una nuova istanza della classe Route usando il modello di URL, i valori dei parametri predefiniti, i vincoli, i valori personalizzati e la classe del gestore specificati.

Proprietà

Constraints	Ottiene o imposta un dizionario di espressioni che specificano i valori validi per un parametro URL.
DataTokens	Ottiene o imposta i valori personalizzati passati al gestore di route, che però non vengono usati per determinare se la route corrisponde a un modello di URL specifico.
Defaults	Ottiene o imposta i valori da usare se l'URL non contiene tutti i parametri.
RouteExistingFiles	Ottiene o imposta un valore che indica se il routing ASP.NET deve gestire gli URL che corrispondono a un file esistente. (Ereditato da RouteBase)
RouteHandler	Ottiene o imposta l'oggetto che elabora le richieste per la route.
Url	Ottiene o imposta il modello di URL per la route.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteData(HttpContextBase)	Restituisce le informazioni sulla route richiesta.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Restituisce le informazioni sull'URL associato alla route.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Determina se un valore del parametro corrisponde al vincolo per il parametro.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Routing di ASP.NET