Route.DataTokens Eigenschaft

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.Routing.dll

Assembly:

System.Web.dll

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.

public:
 property System::Web::Routing::RouteValueDictionary ^ DataTokens { System::Web::Routing::RouteValueDictionary ^ get(); void set(System::Web::Routing::RouteValueDictionary ^ value); };

public System.Web.Routing.RouteValueDictionary DataTokens { get; set; }

member this.DataTokens : System.Web.Routing.RouteValueDictionary with get, set

Public Property DataTokens As RouteValueDictionary

Eigenschaftswert

RouteValueDictionary

Ein Objekt, das benutzerdefinierte Werte enthält.

Beispiele

Das folgende Beispiel zeigt, wie Sie ein Route Objekt erstellen und die ConstraintsEigenschaften DataTokensund Defaults Eigenschaften festlegen.

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    Route reportRoute = new Route("{locale}/{year}", new ReportRouteHandler());
    reportRoute.Defaults = new RouteValueDictionary { { "locale", "en-US" }, { "year", DateTime.Now.Year.ToString() } };
    reportRoute.Constraints = new RouteValueDictionary { { "locale", "[a-z]{2}-[a-z]{2}" }, { "year", @"\d{4}" } };
    reportRoute.DataTokens = new RouteValueDictionary { { "format", "short" } };
    routes.Add(reportRoute);
}

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 reportRoute As Route
    
    urlPattern = "{locale}/{year}"
    
    reportRoute = New Route(urlPattern, New ReportRouteHandler)
    reportRoute.Defaults = New RouteValueDictionary(New With {.locale = "en-US", .year = DateTime.Now.Year.ToString()})
    reportRoute.Constraints = New RouteValueDictionary(New With {.locale = "[a-z]{2}-[a-z]{2}", .year = "\d{4}"})
    reportRoute.DataTokens = New RouteValueDictionary(New With {.format = "short"})

    routes.Add(reportRoute)
End Sub

Hinweise

Mit der DataTokens Eigenschaft können Sie Werte abrufen oder zuweisen, die der Route zugeordnet sind, die nicht verwendet wird, um zu bestimmen, ob eine Route mit einem URL-Muster übereinstimmt. Diese Werte werden an den Routenhandler übergeben und können dann zum Verarbeiten der Anforderung verwendet werden.

Siehe auch

• ASP.NET-Routing