Route Klasse

Definition

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
Abgeleitet

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 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 der Auflistung die Route hinzu Routes . Wenn die Anwendung eine Anforderung empfängt, wird ASP.NET Routing durch die Routen in der Routes Auflistung durchlaufen, 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. Beispiel: In der URL http://www.contoso.com/products/show/beveragesgilt das Muster 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 aus der URL fehlt, oder um zusätzliche Werte festzulegen, die in der URL nicht 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)

Gilt für

Siehe auch