Route Klasse

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Stellt Eigenschaften und Methoden zum Definieren einer Route und zum Abrufen von Informationen über die 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

Im folgenden Beispiel wird gezeigt, wie ein Route Objekt erstellt und der Routes -Eigenschaft hinzugefügt wird.

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 Route der -Klasse können Sie angeben, wie das 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 die Route der Routes Sammlung hinzu. Wenn die Anwendung eine Anforderung empfängt, ASP.NET das Routing durch die Routen in der Routes Auflistung durchlaufen wird, 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 kommen. 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 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 dem URL-Parameter action der Wert showzugewiesen. Wenn das Segment nicht in 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

Route(String, IRouteHandler)	Initialisiert eine neue Instanz der Route-Klasse und verwendet dazu die Angaben für URL-Muster und Handlerklasse.
Route(String, RouteValueDictionary, IRouteHandler)	Initialisiert eine neue Instanz der Route-Klasse, wozu das URL-Muster, die Standardparameterwerte und die Handlerklasse verwendet werden, die angegeben sind.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialisiert eine neue Instanz der Route-Klasse, wozu das URL-Muster, die Standardparameterwerte, die Einschränkungen, und die Handlerklasse verwendet werden, die angegeben sind.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialisiert eine neue Instanz der Route-Klasse, wozu das URL-Muster, die Standardparameterwerte, die Einschränkungen, die benutzerdefinierte Werte und die Handlerklasse verwendet werden, die angegeben sind.

Eigenschaften

Constraints	Ruft ein Wörterbuch von Ausdrücken ab oder legt dieses fest, die gültige Werte für einen URL-Parameter angeben.
DataTokens	Ruft benutzerdefinierte Werte ab oder legt diese fest, die an den Routenhandler übergeben werden, aber nicht verwendet werden, um zu bestimmen, ob die Route mit einem URL-Muster übereinstimmt.
Defaults	Ruft die zu verwendenden Werte ab oder legt diese fest, wenn die URL nicht alle Parameter enthält.
RouteExistingFiles	Ruft einen Wert ab oder legt ihn fest, der anzeigt, ob URLs, die mit einer vorhandenen Datei übereinstimmen, vom ASP.NET-Routing behandelt werden sollen. (Geerbt von RouteBase)
RouteHandler	Ruft das Objekt ab, das Anforderungen für die Route verarbeitet, oder legt es fest.
Url	Ruft das URL-Muster für die Route ab oder legt es fest.

Methoden

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

Weitere Informationen

• ASP.NET-Routing