RouteCollection.Ignore Método

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Define um padrão de URL que não deve ser verificado quanto a correspondências em relação a rotas.

Sobrecargas

Ignore(String, Object)	Define um padrão de URL que não deverá ser verificado quanto a correspondências em relação a rotas, se o URL de uma solicitação atender às restrições especificadas.
Ignore(String)	Define um padrão de URL que não deve ser verificado quanto a correspondências em relação a rotas.

Comentários

Esse método cria uma rota mapeada para o StopRoutingHandler manipulador de rotas. Depois de chamar esse método, as solicitações que correspondem ao padrão de URL especificado não serão processadas como solicitações de rota.

ASP.NET roteamento ignora automaticamente as solicitações quando a URL corresponde a um arquivo físico, como um arquivo de imagem. Em alguns casos, talvez você também queira que o roteamento ignore as solicitações quando não houver nenhum arquivo físico. Por exemplo, as solicitações que ASP.NET faz automaticamente para arquivos .axd não devem ser tratadas como solicitações de rota, embora não haja nenhum arquivo físico que corresponda à extensão de nome de arquivo .axd.

Ignore(String, Object)

Define um padrão de URL que não deverá ser verificado quanto a correspondências em relação a rotas, se o URL de uma solicitação atender às restrições 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

O padrão de URL a ser ignorada.

constraints

Object

Critérios adicionais que determinam se uma solicitação que corresponde ao padrão de URL deve ser ignorada.

Exceções

ArgumentNullException

O parâmetro url é null.

Exemplos

O exemplo a seguir mostra como usar esse método para ignorar todas as URLs que têm uma extensão .aspx. Talvez você queira fazer isso se registrar um manipulador HTTP personalizado para manipular todas as URLs de arquivos que têm a extensão ".aspx". Um único padrão de URL que corresponderia a todas as solicitações de .aspx exigiria dois parâmetros catchall, como {*path}.aspx/{*pathinfo}. (Esse padrão corresponderia a qualquer URL que termine em .aspx, incluindo aquelas que têm parâmetros de cadeia de caracteres de consulta.) No entanto, o roteamento permite apenas um parâmetro catchall no final. Como alternativa, você pode especificar um padrão de URL que tenha um único parâmetro catchall que corresponda a todas as URLs e, em seguida, especifique restrições que excluam tudo o que não tem a extensão .aspx, conforme mostrado no exemplo a seguir:

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

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

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

Comentários

Esse método cria uma rota mapeada para o StopRoutingHandler manipulador de rotas. Depois de chamar esse método, as solicitações que correspondem ao padrão de URL especificado não serão processadas como solicitações de rota.

ASP.NET roteamento ignora automaticamente as solicitações quando a URL corresponde a um arquivo físico, como um arquivo de imagem. Em alguns casos, talvez você também queira que o roteamento ignore as solicitações quando não houver nenhum arquivo físico. Por exemplo, as solicitações que ASP.NET faz automaticamente para arquivos .axd não devem ser tratadas como solicitações de rota, embora não haja nenhum arquivo físico que corresponda à extensão de nome de arquivo .axd.

Confira também

• Roteamento do ASP.NET

Ignore(String)

Define um padrão de URL que não deve ser verificado quanto a correspondências em relação a rotas.

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

O padrão de URL a ser ignorada.

Exemplos

O modelo padrão para projetos MVC usa esse método para excluir arquivos .axd do roteamento, conforme mostrado no exemplo a seguir:

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

Comentários

Esse método cria uma rota mapeada para o StopRoutingHandler manipulador de rotas. Depois de chamar esse método, as solicitações que correspondem ao padrão de URL especificado não serão processadas como solicitações de rota.

ASP.NET roteamento ignora automaticamente as solicitações quando a URL corresponde a um arquivo físico, como um arquivo de imagem. Em alguns casos, talvez você também queira que o roteamento ignore as solicitações quando não houver nenhum arquivo físico. Por exemplo, as solicitações que ASP.NET faz automaticamente para arquivos .axd não devem ser tratadas como solicitações de rota, embora não haja nenhum arquivo físico que corresponda à extensão de nome de arquivo .axd.

Confira também

• Roteamento do ASP.NET