Route.Constraints Propriété

Définition

Espace de noms:

System.Web.Routing

Assembly:

System.Web.Routing.dll

Assembly:

System.Web.dll

Obtient ou définit un dictionnaire des expressions qui spécifient les valeurs valides d’un paramètre d’URL.

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

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

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

Public Property Constraints As RouteValueDictionary

Valeur de propriété

RouteValueDictionary

Objet qui contient les noms et expressions de paramètres.

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

L’exemple suivant montre un Route objet dont Constraints la propriété contient un paramètre nommé httpMethod avec une instance de la HttpMethodConstraint classe pour la valeur.

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

public static void RegisterRoutes(RouteCollection routes)
{
    string[] allowedMethods = { "GET", "POST" };
    HttpMethodConstraint methodConstraints = new HttpMethodConstraint(allowedMethods);

    Route reportRoute = new Route("{locale}/{year}", new ReportRouteHandler());
    reportRoute.Constraints = new RouteValueDictionary { { "httpMethod", methodConstraints } };

    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
    Dim allowedMethods() As String = {"GET", "POST"}
    Dim methodConstraints As HttpMethodConstraint  
    
    methodConstraints = New HttpMethodConstraint(allowedMethods)
    
    Dim constraintValues = New With {.httpMethod = methodConstraints}
    
    urlPattern = "{locale}/{year}"
    
    reportRoute = New Route(urlPattern, New ReportRouteHandler)
    reportRoute.Constraints = New RouteValueDictionary(constraintValues)
    
    routes.Add(reportRoute)
End Sub

Remarques

La Constraints propriété vous permet de limiter les valeurs acceptables pour un paramètre d’URL traité par un itinéraire. Vous affectez un RouteValueDictionary objet à la Constraints propriété. Chaque élément de l’objet RouteValueDictionary contient le nom d’un paramètre et l’un des éléments suivants :

• Chaîne qui définit une expression régulière. L’expression régulière ne respecte pas la casse.

• Objet qui implémente l’interface IRouteConstraint et qui inclut une Match méthode.

La classe HttpMethodConstraint implémente l’interface IRouteConstraint. Vous pouvez inclure une instance de la HttpMethodConstraint classe en tant que contrainte pour spécifier les verbes HTTP acceptables pour l’itinéraire.

Voir aussi

• Routage ASP.NET