Route Klasa

Definicja

Przestrzeń nazw:

System.Web.Routing

Zestaw:

System.Web.Routing.dll

Zestaw:

System.Web.dll

Zawiera właściwości i metody definiowania trasy oraz uzyskiwania informacji o trasie.

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

Dziedziczenie

Object

RouteBase

Route

Pochodne

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Przykłady

W poniższym przykładzie pokazano, jak utworzyć Route obiekt i dodać go do Routes właściwości.

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

Uwagi

Klasa Route umożliwia określenie sposobu przetwarzania routingu w aplikacji ASP.NET. Obiekt jest tworzony Route dla każdego wzorca adresu URL, który ma zostać zamapowyny na klasę, która może obsługiwać żądania odpowiadające temu wzorzecowi. Następnie dodasz trasę do kolekcji Routes . Gdy aplikacja odbiera żądanie, ASP.NET routing iteruje przez trasy w Routes kolekcji, aby znaleźć pierwszą trasę zgodną ze wzorcem adresu URL.

Url Ustaw właściwość na wzorzec adresu URL. Wzorzec adresu URL składa się z segmentów, które pochodzą po nazwie aplikacji w żądaniu HTTP. Na przykład w adresie URL http://www.contoso.com/products/show/beverageswzorzec ma zastosowanie do products/show/beverageselementu . Wzorzec z trzema segmentami, takimi jak {controller}/{action}/{id}, jest zgodny z adresem URL http://www.contoso.com/products/show/beverages. Każdy segment jest rozdzielany znakiem / . Gdy segment jest ujęty w nawiasy klamrowe ({ i }), segment jest określany jako parametr adresu URL. ASP.NET routing pobiera wartość z żądania i przypisuje ją do parametru ADRESU URL. W poprzednim przykładzie parametr action adresu URL jest przypisany do wartości show. Jeśli segment nie jest ujęty w nawiasy klamrowe, wartość jest traktowana jako wartość literału.

Defaults Ustaw właściwość na RouteValueDictionary obiekt, który zawiera wartości używane, jeśli brakuje parametru z adresu URL lub ustawić dodatkowe wartości, które nie są sparametryzowane w adresie URL. Constraints Ustaw właściwość na RouteValueDictionary obiekt zawierający wartości, które są wyrażeniami regularnymi lub IRouteConstraint obiektami. Te wartości służą do określania, czy wartość parametru jest prawidłowa.

Konstruktory

Route(String, IRouteHandler)	Inicjuje Route nowe wystąpienie klasy przy użyciu określonego wzorca adresu URL i klasy obsługi.
Route(String, RouteValueDictionary, IRouteHandler)	Inicjuje Route nowe wystąpienie klasy przy użyciu określonego wzorca adresu URL, domyślnych wartości parametrów i klasy obsługi.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicjuje nowe wystąpienie klasy przy użyciu określonego Route wzorca adresu URL, domyślnych wartości parametrów, ograniczeń i klasy obsługi.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicjuje nowe wystąpienie klasy przy użyciu określonego Route wzorca adresu URL, domyślnych wartości parametrów, ograniczeń, wartości niestandardowych i klasy procedury obsługi.

Właściwości

Constraints	Pobiera lub ustawia słownik wyrażeń, które określają prawidłowe wartości parametru adresu URL.
DataTokens	Pobiera lub ustawia wartości niestandardowe przekazywane do procedury obsługi tras, ale które nie są używane do określenia, czy trasa jest zgodna ze wzorcem adresu URL.
Defaults	Pobiera lub ustawia wartości do użycia, jeśli adres URL nie zawiera wszystkich parametrów.
RouteExistingFiles	Pobiera lub ustawia wartość wskazującą, czy Routing ASP.NET powinien obsługiwać adresy URL zgodne z istniejącym plikiem. (Odziedziczone po RouteBase)
RouteHandler	Pobiera lub ustawia obiekt, który przetwarza żądania dla trasy.
Url	Pobiera lub ustawia wzorzec adresu URL dla trasy.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRouteData(HttpContextBase)	Zwraca informacje o żądanej trasie.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Zwraca informacje o adresie URL skojarzonym z trasą.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Określa, czy wartość parametru jest zgodna z ograniczeniem dla tego parametru.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• routing ASP.NET