RouteCollection.Ignore Methode

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)

Parameter

Ausnahmen

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um alle URLs zu ignorieren, die eine .aspx Erweiterung aufweisen. Möglicherweise möchten Sie dies tun, wenn Sie einen benutzerdefinierten HTTP-Handler registrieren, um alle URLs für Dateien zu verarbeiten, die die Erweiterung ".aspx" aufweisen. Ein einzelnes URL-Muster, das allen .aspx Anforderungen entspricht, erfordert zwei Catchall-Parameter wie {*path}.aspx/{*pathinfo}z. B. . (Dieses Muster entspricht jeder URL, die in .aspx endet, einschließlich derjenigen mit Abfragezeichenfolgenparametern.) Routing lässt jedoch nur einen Catchall-Parameter am Ende zu. Alternativ können Sie ein URL-Muster mit einem einzelnen Catchall-Parameter angeben, der mit allen URLs übereinstimmt, und dann Einschränkungen angeben, die alle Elemente ausschließen, die nicht über die .aspx Erweiterung verfügen, wie im folgenden Beispiel gezeigt:

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

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

Die vorherige Codezeile würde in der Regel zu einer Methode hinzugefügt, die von der Methode in der Application_Start Global.asax aufgerufen wird, wie im Beispiel für die Ignore(String) Überladung gezeigt.

Hinweise

Diese Methode erstellt eine Route, die dem StopRoutingHandler Routenhandler zugeordnet ist. Nachdem Sie diese Methode aufgerufen haben, werden Anforderungen, die mit dem angegebenen URL-Muster übereinstimmen, nicht als Routenanforderungen verarbeitet.

ASP.NET Routing ignoriert Automatisch Anforderungen, wenn die URL mit einer physischen Datei übereinstimmt, z. B. einer Bilddatei. In einigen Fällen möchten Sie möglicherweise auch, dass Routing Anforderungen ignoriert, wenn keine physische Datei vorhanden ist. Beispielsweise sollten die Anforderungen, die ASP.NET automatisch für AXD-Dateien vorgibt, nicht als Routenanforderungen behandelt werden, obwohl keine physische Datei vorhanden ist, die der Erweiterung ".axd" entspricht.

Weitere Informationen

• ASP.NET Routing

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

public void Ignore(string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parameter

Beispiele

Die Standardvorlage für MVC-Projekte verwendet diese Methode, um AXD-Dateien vom Routing auszuschließen, wie im folgenden Beispiel gezeigt:

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

Hinweise

Diese Methode erstellt eine Route, die dem StopRoutingHandler Routenhandler zugeordnet ist. Nachdem Sie diese Methode aufgerufen haben, werden Anforderungen, die mit dem angegebenen URL-Muster übereinstimmen, nicht als Routenanforderungen verarbeitet.

ASP.NET Routing ignoriert Automatisch Anforderungen, wenn die URL mit einer physischen Datei übereinstimmt, z. B. einer Bilddatei. In einigen Fällen möchten Sie möglicherweise auch, dass Routing Anforderungen ignoriert, wenn keine physische Datei vorhanden ist. Beispielsweise sollten die Anforderungen, die ASP.NET automatisch für AXD-Dateien vorgibt, nicht als Routenanforderungen behandelt werden, obwohl keine physische Datei vorhanden ist, die der Erweiterung ".axd" entspricht.

Weitere Informationen

• ASP.NET Routing