RouteCollection.Ignore Méthode

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)

Paramètres

Exceptions

Exemples

L’exemple suivant montre comment utiliser cette méthode pour ignorer toutes les URL qui ont une extension .aspx. Vous pouvez effectuer cette opération si vous inscrivez un gestionnaire HTTP personnalisé pour gérer toutes les URL des fichiers qui ont l’extension « .aspx ». Un modèle d’URL unique qui correspond à toutes les requêtes .aspx nécessite deux paramètres catchall tels que {*path}.aspx/{*pathinfo}. (Ce modèle correspond à n’importe quelle URL qui se termine par .aspx, y compris celles qui ont des paramètres de chaîne de requête.) Toutefois, le routage n’autorise qu’un seul paramètre catchall à la fin. Vous pouvez également spécifier un modèle d’URL qui a un paramètre catchall unique qui correspond à toutes les URL, puis spécifier des contraintes qui excluent tout ce qui n’a pas l’extension .aspx, comme illustré dans l’exemple suivant :

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

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

La ligne de code précédente est généralement ajoutée à une méthode appelée à partir de la Application_Start méthode dans Global.asax, comme indiqué dans l’exemple pour la Ignore(String) surcharge.

Remarques

Cette méthode crée un itinéraire mappé au gestionnaire d’itinéraires StopRoutingHandler . Après avoir appelé cette méthode, les demandes qui correspondent au modèle d’URL spécifié ne sont pas traitées en tant que demandes de routage.

ASP.NET routage ignore automatiquement les demandes lorsque l’URL correspond à un fichier physique, tel qu’un fichier image. Dans certains cas, vous pouvez également souhaiter que le routage ignore les demandes lorsqu’il n’y a pas de fichier physique. Par exemple, les requêtes que ASP.NET effectuent automatiquement pour les fichiers .axd ne doivent pas être traitées comme des demandes de routage, même s’il n’existe aucun fichier physique correspondant à l’extension de nom de fichier .axd.

Voir aussi

• Routage ASP.NET

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

public void Ignore (string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Paramètres

Exemples

Le modèle par défaut pour les projets MVC utilise cette méthode pour exclure les fichiers .axd du routage, comme illustré dans l’exemple suivant :

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

Remarques

Cette méthode crée un itinéraire mappé au gestionnaire d’itinéraires StopRoutingHandler . Après avoir appelé cette méthode, les demandes qui correspondent au modèle d’URL spécifié ne sont pas traitées en tant que demandes de routage.

ASP.NET routage ignore automatiquement les demandes lorsque l’URL correspond à un fichier physique, tel qu’un fichier image. Dans certains cas, vous pouvez également souhaiter que le routage ignore les demandes lorsqu’il n’y a pas de fichier physique. Par exemple, les requêtes que ASP.NET effectuent automatiquement pour les fichiers .axd ne doivent pas être traitées comme des demandes de routage, même s’il n’existe aucun fichier physique correspondant à l’extension de nom de fichier .axd.

Voir aussi

• Routage ASP.NET