Partager via

RouteCollection.Ignore Méthode

  • Référence

Définition

Espace de noms:
System.Web.Routing
Assembly:
System.Web.dll

Définit un modèle d'URL dont les correspondances par rapport à des itinéraires ne doivent pas être vérifiées.

Surcharges

Ignore(String, Object)

Définit un modèle d'URL qui ne doit pas être vérifié pour les correspondances par rapport à des itinéraires si une URL de requête satisfait les contraintes spécifiées.
Ignore(String)

Définit un modèle d'URL dont les correspondances par rapport à des itinéraires ne doivent pas être vérifiées.

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.

Ignore(String, Object)

Définit un modèle d'URL qui ne doit pas être vérifié pour les correspondances par rapport à des itinéraires si une URL de requête satisfait les contraintes spécifiées.

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

url
String

Modèle d'URL à ignorer.

constraints
Object

Critère supplémentaire qui détermine si une demande qui correspond au modèle d'URL sera ignorée.

Exceptions

ArgumentNullException

Le paramètre url a la valeur null.

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

S’applique à

Ignore(String)

Définit un modèle d'URL dont les correspondances par rapport à des itinéraires ne doivent pas être vérifiées.

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

Paramètres

url
String

Modèle d'URL à ignorer.

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

S’applique à