RouteCollection.Ignore Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.