Route.DataTokens Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property DataTokens As RouteValueDictionaryEigenschaftswert
Ein Objekt, das benutzerdefinierte Werte enthält.
Beispiele
Das folgende Beispiel zeigt, wie Sie ein Route -Objekt erstellen und die ConstraintsEigenschaften , DataTokensund Defaults 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
Sie verwenden die DataTokens -Eigenschaft zum Abrufen oder Zuweisen von Werten, die der Route zugeordnet sind und nicht verwendet werden, um zu bestimmen, ob eine Route einem URL-Muster entspricht. Diese Werte werden an den Routenhandler übergeben und können dann zum Verarbeiten der Anforderung verwendet werden.
