Route.DataTokens Propriété

Définition

Espace de noms:

System.Web.Routing

Assembly:

System.Web.Routing.dll

Assembly:

System.Web.dll

Obtient ou définit des valeurs personnalisées qui sont passées au gestionnaire d’itinéraires, mais qui ne sont pas utilisées pour déterminer si l’itinéraire correspond à un modèle d’URL.

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

Valeur de propriété

RouteValueDictionary

Objet qui contient des valeurs personnalisées.

Exemples

L’exemple suivant montre comment créer un Route objet et définir les propriétés , et Defaults les ConstraintsDataTokenspropriétés.

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

Remarques

Vous utilisez la DataTokens propriété pour récupérer ou affecter des valeurs associées à l’itinéraire qui ne sont pas utilisées pour déterminer si un itinéraire correspond à un modèle d’URL. Ces valeurs sont passées au gestionnaire d’itinéraires, où elles peuvent être utilisées pour le traitement de la requête.

Voir aussi

• Routage ASP.NET