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 de StopRoutingHandler routes. Après avoir appelé cette méthode, les demandes qui correspondent au modèle d’URL spécifié ne sont pas traitées comme des 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’existe aucun fichier physique. Par exemple, les demandes 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 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 à toutes les URL qui se terminent 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 seul paramètre catchall 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 de StopRoutingHandler routes. Après avoir appelé cette méthode, les demandes qui correspondent au modèle d’URL spécifié ne sont pas traitées comme des 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’existe aucun fichier physique. Par exemple, les demandes 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 de StopRoutingHandler routes. Après avoir appelé cette méthode, les demandes qui correspondent au modèle d’URL spécifié ne sont pas traitées comme des 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’existe aucun fichier physique. Par exemple, les demandes 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 à