Route.Url Propiedad

Definición

Espacio de nombres:

System.Web.Routing

Ensamblado:

System.Web.dll

Obtiene o establece el patrón de la dirección URL de la ruta.

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

Valor de propiedad

String

Patrón para hacer coincidir la ruta con una dirección URL.

Excepciones

ArgumentException

Cualquiera de los siguientes:

• El valor empieza por ~ o /.

• El valor contiene un ? carácter.

• El parámetro catch-all no es el último.

Exception

Los segmentos de direcciones URL no están separados por un delimitador o una constante literal.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la Url propiedad en el constructor de clase. El patrón contiene el valor literal "Category" para el primer segmento y los parámetros de dirección URL para los dos segmentos siguientes.

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

Comentarios

Cuando se asigna un valor a la Url propiedad , el / carácter se interpreta como delimitador cuando se analiza la dirección URL. Use llaves ({}) para definir una variable a la que se hace referencia como parámetro de dirección URL. El valor del segmento coincidente de la dirección URL se asigna al parámetro URL. Los valores de la Url propiedad que no están entre llaves se tratan como constantes literales.

No ? se permite el carácter en la Url propiedad . Cada segmento de dirección URL debe estar separado por un delimitador o una constante literal. Puede usar {{ o }} como caracteres de escape para un carácter de llave.

Consulte también

• Enrutamiento de ASP.NET