Lenguaje

RouteCollection.Ignore Método

Definición

Define un patrón de dirección URL que no se debe comprobar para buscar coincidencias con las rutas.

Sobrecargas

Nombre Description
Ignore(String, Object)

Define un patrón de dirección URL que no debe comprobarse para buscar coincidencias con rutas si una dirección URL de solicitud cumple las restricciones especificadas.

Ignore(String)

Define un patrón de dirección URL que no se debe comprobar para buscar coincidencias 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 patrón de dirección URL que no debe comprobarse para buscar coincidencias con rutas si una dirección URL de 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

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

constraints
Object

Criterios adicionales que determinan si se omitirá una solicitud que coincida con el patrón de dirección URL.

Excepciones

El url parámetro 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 .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 patrón de dirección URL que no se debe comprobar para buscar coincidencias 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

Patrón 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