Route.Url Propriété

Définition

Espace de noms:

System.Web.Routing

Assembly:

System.Web.Routing.dll

Assembly:

System.Web.dll

Obtient ou définit le modèle d’URL pour la route.

public:
 property System::String ^ Url { System::String ^ get(); void set(System::String ^ value); };

public string Url { get; set; }

member this.Url : string with get, set

Public Property Url As String

Valeur de propriété

String

Le modèle pour mettre en correspondance la route avec une URL.

Exceptions

ArgumentException

Un des éléments suivants :

• La valeur commence par ~ ou /.

• La valeur contient un caractère ? .

• Le paramètre catch-all n’est pas le dernier.

Exception

Les segments d’URL ne sont pas séparés par un délimiteur ou une constante littérale.

Exemples

L’exemple suivant montre comment définir la Url propriété dans le constructeur de classe. Le modèle contient la valeur littérale « Category » pour les premiers paramètres de segment et d’URL pour les deux segments suivants.

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

public static void RegisterRoutes(RouteCollection routes)
{
    routes.Add(new Route
    (
         "Category/{action}/{categoryName}"
         , new CategoryRouteHandler()
    ));
}

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 categoryRoute As Route
    
    urlPattern = "Category/{action}/{categoryName}"
    
    categoryRoute = New Route(urlPattern, New CategoryRouteHandler)
    
    routes.Add(categoryRoute)
End Sub

Remarques

Lorsque vous affectez une valeur à la Url propriété, le / caractère est interprété comme un délimiteur lorsque l’URL est analysée. Utilisez des accolades ({}) pour définir une variable appelée paramètre d’URL. La valeur du segment correspondant dans l’URL est affectée au paramètre d’URL. Toutes les valeurs de la Url propriété qui ne sont pas placées entre accolades sont traitées comme des constantes littérales.

Le ? caractère n’est pas autorisé dans la Url propriété. Chaque segment d’URL doit être séparé par une constante délimiteur ou littérale. Vous pouvez utiliser {{ ou }} comme caractères d’échappement pour un caractère d’accolades.

Voir aussi

• Routage ASP.NET