RouteCollection.Ignore Método

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

Exceções

Exemplos

O exemplo seguinte mostra como usar este método para ignorar todas as URLs que tenham uma extensão .aspx. Pode querer fazer isto se registar um handler HTTP personalizado para tratar de todos os URLs de ficheiros que tenham a extensão ".aspx". Um único padrão de URL que correspondesse a todos os pedidos .aspx exigiria dois parâmetros catchall, como {*path}.aspx/{*pathinfo}. (Este padrão corresponderia a qualquer URL que termine em .aspx, incluindo aquelas que tenham parâmetros de sequência de consulta.) No entanto, o encaminhamento permite apenas um parâmetro catchall no final. Como alternativa, pode especificar um padrão de URL que tenha um único parâmetro catchall que corresponda a todas as URLs e depois especificar restrições que excluam tudo o que não tem a extensão .aspx, como mostrado no exemplo seguinte:

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

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

A linha de código anterior seria normalmente adicionada a um método que é chamado do Application_Start método no Global.asax, como mostrado no exemplo da Ignore(String) sobrecarga.

Observações

Este método cria uma rota que é mapeada para o StopRoutingHandler gestor de rotas. Depois de chamar este método, pedidos que correspondam ao padrão de URL especificado não serão processados como pedidos de rota.

O encaminhamento ASP.NET ignora automaticamente os pedidos quando a URL corresponde a um ficheiro físico, como um ficheiro de imagem. Em alguns casos, também pode querer que o encaminhamento ignore pedidos quando não há ficheiro físico. Por exemplo, os pedidos que o ASP.NET faz automaticamente para ficheiros .axd não devem ser tratados como requests de rota, mesmo que não exista nenhum ficheiro físico correspondente à extensão do nome .axd.

Consulte também

• Roteamento ASP.NET

public:
 void Ignore(System::String ^ url);

public void Ignore(string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parâmetros

Exemplos

O modelo padrão para projetos MVC usa este método para excluir ficheiros .axd do encaminhamento, como mostrado no exemplo seguinte:

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

Observações

Este método cria uma rota que é mapeada para o StopRoutingHandler gestor de rotas. Depois de chamar este método, pedidos que correspondam ao padrão de URL especificado não serão processados como pedidos de rota.

O encaminhamento ASP.NET ignora automaticamente os pedidos quando a URL corresponde a um ficheiro físico, como um ficheiro de imagem. Em alguns casos, também pode querer que o encaminhamento ignore pedidos quando não há ficheiro físico. Por exemplo, os pedidos que o ASP.NET faz automaticamente para ficheiros .axd não devem ser tratados como requests de rota, mesmo que não exista nenhum ficheiro físico correspondente à extensão do nome .axd.

Consulte também

• Roteamento ASP.NET