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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze methode gebruikt om alle URL's met een .aspx-extensie te negeren. U kunt dit doen als u een aangepaste HTTP-handler registreert om alle URL's te verwerken voor bestanden met de extensie '.aspx'. Voor één URL-patroon dat overeenkomt met alle .aspx aanvragen, zijn twee catchall-parameters nodig, zoals {*path}.aspx/{*pathinfo}. (Dit patroon komt overeen met elke URL die eindigt op .aspx, inclusief url's met queryreeksparameters.) Routering staat echter slechts één catchall-parameter aan het einde toe. Als alternatief kunt u een URL-patroon opgeven met één catchall-parameter die overeenkomt met alle URL's en vervolgens beperkingen opgeven die alles uitsluiten dat niet beschikt over de .aspx-extensie, zoals wordt weergegeven in het volgende voorbeeld:

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

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

De vorige regel code wordt doorgaans toegevoegd aan een methode die wordt aangeroepen vanuit de Application_Start methode in Global.asax, zoals wordt weergegeven in het voorbeeld voor de Ignore(String) overbelasting.

Opmerkingen

Met deze methode maakt u een route die is toegewezen aan de StopRoutingHandler route-handler. Nadat u deze methode hebt aangeroepen, worden aanvragen die overeenkomen met het opgegeven URL-patroon niet verwerkt als routeaanvragen.

ASP.NET routering automatisch aanvragen negeert wanneer de URL overeenkomt met een fysiek bestand, zoals een afbeeldingsbestand. In sommige gevallen wilt u mogelijk ook aanvragen negeren wanneer er geen fysiek bestand is. De aanvragen die ASP.NET automatisch voor AXD-bestanden maken, mogen bijvoorbeeld niet worden behandeld als routeaanvragen, ook al is er geen fysiek bestand dat overeenkomt met de bestandsextensie .axd.

Zie ook

• ASP.NET-routering

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

public void Ignore(string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parameters

Voorbeelden

In de standaardsjabloon voor MVC-projecten wordt deze methode gebruikt om AXD-bestanden uit te sluiten van routering, zoals wordt weergegeven in het volgende voorbeeld:

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

Opmerkingen

Met deze methode maakt u een route die is toegewezen aan de StopRoutingHandler route-handler. Nadat u deze methode hebt aangeroepen, worden aanvragen die overeenkomen met het opgegeven URL-patroon niet verwerkt als routeaanvragen.

ASP.NET routering automatisch aanvragen negeert wanneer de URL overeenkomt met een fysiek bestand, zoals een afbeeldingsbestand. In sommige gevallen wilt u mogelijk ook aanvragen negeren wanneer er geen fysiek bestand is. De aanvragen die ASP.NET automatisch voor AXD-bestanden maken, mogen bijvoorbeeld niet worden behandeld als routeaanvragen, ook al is er geen fysiek bestand dat overeenkomt met de bestandsextensie .axd.

Zie ook

• ASP.NET-routering