Route Klasse

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Stellt Eigenschaften und Methoden zum Definieren einer Route und zum Abrufen von Informationen zur Route bereit.

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

Vererbung

Object

RouteBase

Route

Abgeleitet

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Beispiele

Das folgende Beispiel zeigt, wie Sie ein Route Objekt erstellen und der Routes Eigenschaft hinzufügen.

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

Hinweise

Mit der Route Klasse können Sie angeben, wie routing in einer ASP.NET Anwendung verarbeitet wird. Sie erstellen ein Route Objekt für jedes URL-Muster, das Sie einer Klasse zuordnen möchten, die Anforderungen verarbeiten kann, die diesem Muster entsprechen. Anschließend fügen Sie der Sammlung die Route hinzu Routes . Wenn die Anwendung eine Anforderung empfängt, durchläuft ASP.NET Routing die Routen in der Routes Auflistung, um die erste Route zu finden, die dem Muster der URL entspricht.

Legen Sie die Url Eigenschaft auf ein URL-Muster fest. Das URL-Muster besteht aus Segmenten, die nach dem Anwendungsnamen in einer HTTP-Anforderung stammen. In der URL http://www.contoso.com/products/show/beveragesgilt das Muster beispielsweise für products/show/beverages. Ein Muster mit drei Segmenten, z {controller}/{action}/{id}. B. , entspricht der URL http://www.contoso.com/products/show/beverages. Jedes Segment wird durch das / Zeichen getrennt. Wenn ein Segment in geschweifte Klammern ({ und }) eingeschlossen ist, wird das Segment auf einen URL-Parameter verwiesen. ASP.NET Routing ruft den Wert aus der Anforderung ab und weist ihn dem URL-Parameter zu. Im vorherigen Beispiel wird der URL-Parameter action dem Wert showzugewiesen. Wenn das Segment nicht in geschweifte Klammern eingeschlossen ist, wird der Wert als Literalwert behandelt.

Legen Sie die Defaults Eigenschaft auf ein RouteValueDictionary Objekt fest, das Werte enthält, die verwendet werden, wenn ein Parameter in der URL fehlt, oder um zusätzliche Werte festzulegen, die nicht in der URL parametrisiert sind. Legen Sie die Constraints Eigenschaft auf ein RouteValueDictionary Objekt fest, das Werte enthält, die entweder reguläre Ausdrücke oder IRouteConstraint Objekte sind. Diese Werte werden verwendet, um zu bestimmen, ob ein Parameterwert gültig ist.

Konstruktoren

Name	Beschreibung
Route(String, IRouteHandler)	Initialisiert eine neue Instanz der Route Klasse mithilfe des angegebenen URL-Musters und der Handlerklasse.
Route(String, RouteValueDictionary, IRouteHandler)	Initialisiert eine neue Instanz der Route Klasse mithilfe des angegebenen URL-Musters, der Standardparameterwerte und der Handlerklasse.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialisiert eine neue Instanz der Route Klasse mithilfe des angegebenen URL-Musters, standardparameterwerte, Einschränkungen und Handlerklasse.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialisiert eine neue Instanz der Route Klasse mithilfe des angegebenen URL-Musters, standardparameterwerte, Einschränkungen, benutzerdefinierte Werte und Handlerklasse.

Eigenschaften

Name	Beschreibung
Constraints	Dient zum Abrufen oder Festlegen eines Wörterbuchs von Ausdrücken, die gültige Werte für einen URL-Parameter angeben.
DataTokens	Ruft benutzerdefinierte Werte ab, die an den Routenhandler übergeben werden, aber nicht verwendet werden, um zu bestimmen, ob die Route mit einem URL-Muster übereinstimmt, oder legt diese fest.
Defaults	Ruft die zu verwendenden Werte ab, wenn die URL nicht alle Parameter enthält, oder legt sie fest.
RouteExistingFiles	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ASP.NET Routing URLs verarbeiten soll, die einer vorhandenen Datei entsprechen. (Geerbt von RouteBase)
RouteHandler	Dient zum Abrufen oder Festlegen des Objekts, das Anforderungen für die Route verarbeitet.
Url	Dient zum Abrufen oder Festlegen des URL-Musters für die Route.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetRouteData(HttpContextBase)	Gibt Informationen zur angeforderten Route zurück.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Gibt Informationen zur URL zurück, die der Route zugeordnet ist.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Bestimmt, ob ein Parameterwert der Einschränkung für diesen Parameter entspricht.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• ASP.NET Routing