Route Classe

Definizione

Spazio dei nomi:

System.Web.Routing

Assembly:

System.Web.dll

Fornisce proprietà e metodi per la definizione di 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 seguente viene illustrato come creare un Route oggetto e aggiungerlo alla Routes 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 come viene elaborato il routing in un'applicazione ASP.NET. Si crea un Route oggetto per ogni modello di URL di cui si vuole eseguire il mapping a una classe in grado di gestire le richieste che corrispondono a tale modello. Si aggiunge quindi la route alla Routes raccolta. Quando l'applicazione riceve una richiesta, ASP.NET il routing scorre le route nella Routes raccolta per trovare la prima route che corrisponde al modello dell'URL.

Impostare la Url proprietà su un modello URL. Il modello di URL è costituito da segmenti che derivano dal 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. Un 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, al parametro action URL viene assegnato il 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 utilizzati se manca un parametro nell'URL o per impostare valori aggiuntivi non parametrizzati nell'URL. Impostare la Constraints proprietà su un RouteValueDictionary oggetto che contiene valori che sono espressioni regolari o IRouteConstraint oggetti. Questi valori vengono usati per determinare se un valore di parametro è valido.

Costruttori

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

Proprietà

Nome	Descrizione
Constraints	Ottiene o imposta un dizionario di espressioni che specificano valori validi per un parametro URL.
DataTokens	Ottiene o imposta valori personalizzati passati al gestore di route, ma che non vengono usati per determinare se la route corrisponde a un modello URL.
Defaults	Ottiene o imposta i valori da utilizzare se l'URL non contiene tutti i parametri.
RouteExistingFiles	Ottiene o imposta un valore che indica se ASP.NET routing deve gestire gli URL corrispondenti 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 URL per la route.

Metodi

Nome	Descrizione
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 informazioni sulla route richiesta.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Restituisce informazioni sull'URL associato alla route.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Determina se un valore di parametro corrisponde al vincolo per tale parametro.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• ASP.NET Routing