Langue

RouteCollection.Ignore Méthode

Définition

Définit un modèle d’URL qui ne doit pas être vérifié pour les correspondances par rapport aux itinéraires.

Surcharges

Nom Description
Ignore(String, Object)

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

Ignore(String)

Définit un modèle d’URL qui ne doit pas être vérifié pour les correspondances par rapport aux itinéraires.

Remarques

Cette méthode crée un itinéraire mappé au gestionnaire de StopRoutingHandler routage. Après avoir appelé cette méthode, les requêtes qui correspondent au modèle d’URL spécifié ne seront 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 souhaiterez peut-être également que le routage ignore les demandes lorsqu’il n’existe aucun fichier physique. Par exemple, les demandes que ASP.NET effectue 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 qui correspond à 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 aux itinéraires si une URL de requête répond aux 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ères supplémentaires qui déterminent si une requête qui correspond au modèle d’URL sera ignorée.

Exceptions

Le url paramètre est null.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour ignorer toutes les URL qui ont une extension .aspx. Vous pouvez le faire 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 correspondrait à toutes les requêtes .aspx nécessiterait 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. En guise d’alternative, vous pouvez 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 illustré dans l’exemple de surcharge Ignore(String) .

Remarques

Cette méthode crée un itinéraire mappé au gestionnaire de StopRoutingHandler routage. Après avoir appelé cette méthode, les requêtes qui correspondent au modèle d’URL spécifié ne seront 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 souhaiterez peut-être également que le routage ignore les demandes lorsqu’il n’existe aucun fichier physique. Par exemple, les demandes que ASP.NET effectue 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 qui correspond à l’extension de nom de fichier .axd.

Voir aussi

S’applique à

Ignore(String)

Définit un modèle d’URL qui ne doit pas être vérifié pour les correspondances par rapport aux itinéraires.

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 de StopRoutingHandler routage. Après avoir appelé cette méthode, les requêtes qui correspondent au modèle d’URL spécifié ne seront 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 souhaiterez peut-être également que le routage ignore les demandes lorsqu’il n’existe aucun fichier physique. Par exemple, les demandes que ASP.NET effectue 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 qui correspond à l’extension de nom de fichier .axd.

Voir aussi

S’applique à