RouteCollection.Ignore Metod

Definition

Namnområde:
System.Web.Routing
Sammansättning:
System.Web.dll

Definierar ett URL-mönster som inte ska kontrolleras för matchningar mot vägar.

Överlagringar

Name Description
Ignore(String, Object)

Definierar ett URL-mönster som inte ska kontrolleras för matchningar mot vägar om en url för begäran uppfyller de angivna begränsningarna.
Ignore(String)

Definierar ett URL-mönster som inte ska kontrolleras för matchningar mot vägar.

Kommentarer

Den här metoden skapar en väg som mappas till routningshanteraren StopRoutingHandler . När du har anropat den här metoden bearbetas inte begäranden som matchar det angivna URL-mönstret som routningsbegäranden.

ASP.NET routning ignorerar automatiskt begäranden när URL:en matchar en fysisk fil, till exempel en bildfil. I vissa fall kanske du också vill att routning ska ignorera begäranden när det inte finns någon fysisk fil. Till exempel bör begäranden som ASP.NET automatiskt gör för .axd-filer inte behandlas som routningsbegäranden trots att det inte finns någon fysisk fil som motsvarar filnamnstillägget .axd.

Ignore(String, Object)

Definierar ett URL-mönster som inte ska kontrolleras för matchningar mot vägar om en url för begäran uppfyller de angivna begränsningarna.

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)

Parametrar

url
String

Url-mönstret som ska ignoreras.

constraints
Object

Ytterligare kriterier som avgör om en begäran som matchar URL-mönstret ignoreras.

Undantag

ArgumentNullException

Parametern url är null.

Exempel

I följande exempel visas hur du använder den här metoden för att ignorera alla URL:er som har ett .aspx-tillägg. Du kanske vill göra detta om du registrerar en anpassad HTTP-hanterare för att hantera alla URL:er för filer som har tillägget ".aspx". Ett enda URL-mönster som skulle matcha alla .aspx begäranden skulle kräva två catchall-parametrar som {*path}.aspx/{*pathinfo}. (Det här mönstret skulle matcha alla URL:er som slutar i .aspx, inklusive de som har frågesträngsparametrar.) Routning tillåter dock bara en catchall-parameter i slutet. Alternativt kan du ange ett URL-mönster som har en enda catchall-parameter som matchar alla URL:er och sedan ange begränsningar som utesluter allt som inte har tillägget .aspx, som du ser i följande exempel:

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

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

Den föregående kodraden skulle vanligtvis läggas till i en metod som anropas från Application_Start metoden i Global.asax, som du ser i exemplet för överbelastningen Ignore(String) .

Kommentarer

Den här metoden skapar en väg som mappas till routningshanteraren StopRoutingHandler . När du har anropat den här metoden bearbetas inte begäranden som matchar det angivna URL-mönstret som routningsbegäranden.

ASP.NET routning ignorerar automatiskt begäranden när URL:en matchar en fysisk fil, till exempel en bildfil. I vissa fall kanske du också vill att routning ska ignorera begäranden när det inte finns någon fysisk fil. Till exempel bör begäranden som ASP.NET automatiskt gör för .axd-filer inte behandlas som routningsbegäranden trots att det inte finns någon fysisk fil som motsvarar filnamnstillägget .axd.

Se även

Gäller för

Ignore(String)

Definierar ett URL-mönster som inte ska kontrolleras för matchningar mot vägar.

public:
 void Ignore(System::String ^ url);
public void Ignore(string url);
member this.Ignore : string -> unit
Public Sub Ignore (url As String)

Parametrar

url
String

Url-mönstret som ska ignoreras.

Exempel

Standardmallen för MVC-projekt använder den här metoden för att undanta .axd-filer från routning, som du ser i följande exempel:

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

Kommentarer

Den här metoden skapar en väg som mappas till routningshanteraren StopRoutingHandler . När du har anropat den här metoden bearbetas inte begäranden som matchar det angivna URL-mönstret som routningsbegäranden.

ASP.NET routning ignorerar automatiskt begäranden när URL:en matchar en fysisk fil, till exempel en bildfil. I vissa fall kanske du också vill att routning ska ignorera begäranden när det inte finns någon fysisk fil. Till exempel bör begäranden som ASP.NET automatiskt gör för .axd-filer inte behandlas som routningsbegäranden trots att det inte finns någon fysisk fil som motsvarar filnamnstillägget .axd.

Se även

Gäller för