Route.DataTokens Свойство

Определение

Возвращает или задает пользовательские значения, передаваемые обработчику маршрута, но не используемые для определения соответствия маршрута заданному шаблону URL-адреса.Gets or sets custom values that are passed to the route handler, but which are not used to determine whether the route matches a URL pattern.

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

Значение свойства

Объект, содержащий пользовательские значения.An object that contains custom values.

Примеры

Route В следующем примере показано Constraints, как создать объект и задать свойства, DataTokensи Defaults .The following example shows how to create a Route object and set the Constraints, DataTokens, and Defaults properties.

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

Комментарии

DataTokens Свойство используется для получения или назначения значений, связанных с маршрутом, которые не используются для определения того, соответствует ли маршрут шаблону URL-адреса.You use the DataTokens property to retrieve or assign values associated with the route that are not used to determine whether a route matches a URL pattern. Эти значения передаются обработчику маршрута, когда они могут использоваться для обработки запроса.These values are passed to the route handler, where they can be used for processing the request.

Применяется к

Дополнительно