Compartir a través de

RouteCollection.Ignore Método

  • Referencia

Definición

Espacio de nombres:
System.Web.Routing
Ensamblado:
System.Web.dll

Define un modelo de dirección URL que no debe compararse con las rutas.

Sobrecargas

Ignore(String, Object)

Define un modelo de dirección URL que no debe compararse con las rutas si la dirección URL de una solicitud cumple las restricciones especificadas.
Ignore(String)

Define un modelo de dirección URL que no debe compararse con las rutas.

Comentarios

Este método crea una ruta que se asigna al controlador de StopRoutingHandler ruta. Después de llamar a este método, las solicitudes que coinciden con el patrón de dirección URL especificado no se procesarán como solicitudes de ruta.

ASP.NET enrutamiento omite automáticamente las solicitudes cuando la dirección URL coincide con un archivo físico, como un archivo de imagen. En algunos casos, es posible que también quiera que el enrutamiento omita las solicitudes cuando no haya ningún archivo físico. Por ejemplo, las solicitudes que ASP.NET realiza automáticamente para los archivos .axd no deben tratarse como solicitudes de ruta aunque no haya ningún archivo físico que corresponda a la extensión de nombre de archivo .axd.

Ignore(String, Object)

Define un modelo de dirección URL que no debe compararse con las rutas si la dirección URL de una solicitud cumple las restricciones especificadas.

public:
 void Ignore(System::String ^ url, System::Object ^ constraints);
public void Ignore (string url, object constraints);
member this.Ignore : string * obj -> unit
Public Sub Ignore (url As String, constraints As Object)

Parámetros

url
String

Modelo de dirección URL que se va a omitir.

constraints
Object

Criterios adicionales que determinan si se va a omitir una solicitud que coincide con el modelo de dirección URL.

Excepciones

ArgumentNullException

El parámetro url es null.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este método para omitir todas las direcciones URL que tienen una extensión de .aspx. Es posible que quiera hacerlo si registra un controlador HTTP personalizado para controlar todas las direcciones URL de los archivos que tienen la extensión ".aspx". Un único patrón de dirección URL que coincidiría con todas las solicitudes de .aspx requeriría dos parámetros catchall, como {*path}.aspx/{*pathinfo}. (Este patrón coincidiría con cualquier dirección URL que termine en .aspx, incluidas las que tienen parámetros de cadena de consulta). Sin embargo, el enrutamiento solo permite un parámetro catchall al final. Como alternativa, puede especificar un patrón de dirección URL que tenga un único parámetro catchall que coincida con todas las direcciones URL y, a continuación, especificar restricciones que excluyan todo lo que no tenga la extensión .aspx, como se muestra en el ejemplo siguiente:

routes.Ignore("{*allaspx}", new With {.allaspx = ".*\.aspx(/.*)?"})

routes.Ignore("{*allaspx}", new {allaspx=@".*\.aspx(/.*)?"});

Normalmente, la línea de código anterior se agregaría a un método al que se llama desde el Application_Start método en Global.asax, como se muestra en el ejemplo de la Ignore(String) sobrecarga.

Comentarios

Este método crea una ruta que se asigna al controlador de StopRoutingHandler ruta. Después de llamar a este método, las solicitudes que coinciden con el patrón de dirección URL especificado no se procesarán como solicitudes de ruta.

ASP.NET enrutamiento omite automáticamente las solicitudes cuando la dirección URL coincide con un archivo físico, como un archivo de imagen. En algunos casos, es posible que también quiera que el enrutamiento omita las solicitudes cuando no haya ningún archivo físico. Por ejemplo, las solicitudes que ASP.NET realiza automáticamente para los archivos .axd no deben tratarse como solicitudes de ruta aunque no haya ningún archivo físico que corresponda a la extensión de nombre de archivo .axd.

Consulte también

Se aplica a

Ignore(String)

Define un modelo de dirección URL que no debe compararse con las rutas.

public:
 void Ignore(System::String ^ url);
public void Ignore (string url);
member this.Ignore : string -> unit
Public Sub Ignore (url As String)

Parámetros

url
String

Modelo de dirección URL que se va a omitir.

Ejemplos

La plantilla predeterminada para proyectos de MVC usa este método para excluir los archivos .axd del enrutamiento, como se muestra en el ejemplo siguiente:

public class MvcApplication : System.Web.HttpApplication
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

        routes.MapRoute(
            "Default",                                              // Route name
            "{controller}/{action}/{id}",                           // URL with parameters
            new { controller = "Home", action = "Index", id = "" }  // Parameter defaults
        );
    }

    protected void Application_Start()
    {
        RegisterRoutes(RouteTable.Routes);
    }
}

Public Class MvcApplication
    Inherits System.Web.HttpApplication

    Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}")

        ' MapRoute takes the following parameters, in order:
        ' (1) Route name
        ' (2) URL with parameters
        ' (3) Parameter defaults
        routes.MapRoute( _
            "Default", _
            "{controller}/{action}/{id}", _
            New With {.controller = "Home", .action = "Index", .id = ""} _
        )

    End Sub

    Sub Application_Start()
        RegisterRoutes(RouteTable.Routes)
    End Sub
End Class

Comentarios

Este método crea una ruta que se asigna al controlador de StopRoutingHandler ruta. Después de llamar a este método, las solicitudes que coinciden con el patrón de dirección URL especificado no se procesarán como solicitudes de ruta.

ASP.NET enrutamiento omite automáticamente las solicitudes cuando la dirección URL coincide con un archivo físico, como un archivo de imagen. En algunos casos, es posible que también quiera que el enrutamiento omita las solicitudes cuando no haya ningún archivo físico. Por ejemplo, las solicitudes que ASP.NET realiza automáticamente para los archivos .axd no deben tratarse como solicitudes de ruta aunque no haya ningún archivo físico que corresponda a la extensión de nombre de archivo .axd.

Consulte también

Se aplica a