RouteCollection.Ignore Metoda

Definice

Obor názvů:

System.Web.Routing

Sestavení:

System.Web.dll

Definuje vzor adresy URL, u kterého by se neměly kontrolovat shody s trasami.

Přetížení

Ignore(String, Object)	Definuje vzor adresy URL, u kterého by se neměly kontrolovat shody s trasami, pokud adresa URL požadavku splňuje zadaná omezení.
Ignore(String)	Definuje vzor adresy URL, u kterého by se neměly kontrolovat shody s trasami.

Poznámky

Tato metoda vytvoří trasu, která je namapována na obslužnou rutinu StopRoutingHandler trasy. Po volání této metody se požadavky, které odpovídají zadanému vzoru adresy URL, nezpracují jako požadavky směrování.

ASP.NET směrování automaticky ignoruje požadavky, pokud adresa URL odpovídá fyzickému souboru, například souboru obrázku. V některých případech můžete také chtít, aby směrování ignorovaly požadavky, když neexistuje žádný fyzický soubor. Například požadavky, které ASP.NET automaticky provádí pro soubory .axd, by neměly být považovány za požadavky směrování, i když neexistuje žádný fyzický soubor, který by odpovídal příponě názvu souboru .axd.

Ignore(String, Object)

Definuje vzor adresy URL, u kterého by se neměly kontrolovat shody s trasami, pokud adresa URL požadavku splňuje zadaná omezení.

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)

Parametry

url

String

Vzor adresy URL, který se má ignorovat.

constraints

Object

Další kritéria, která určují, jestli bude požadavek, který odpovídá vzoru adresy URL, ignorován.

Výjimky

ArgumentNullException

Parametr url je null.

Příklady

Následující příklad ukazuje, jak pomocí této metody ignorovat všechny adresy URL, které mají příponu .aspx. Můžete to udělat, pokud zaregistrujete vlastní obslužnou rutinu HTTP pro zpracování všech adres URL souborů s příponou ".aspx". Jeden vzor adresy URL, který by odpovídal všem požadavkům .aspx, by vyžadoval dva univerzální parametry, například {*path}.aspx/{*pathinfo}. (Tento vzor by odpovídal všem adresám URL, které končí na .aspx, včetně těch, které mají parametry řetězce dotazu.) Směrování však umožňuje pouze jeden parametr catchall na konci. Alternativně můžete zadat vzor adresy URL, který má jeden parametr catchall, který odpovídá všem adresám URL, a pak zadat omezení, která vyloučí všechno, co nemá příponu .aspx, jak je znázorněno v následujícím příkladu:

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

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

Předchozí řádek kódu by se obvykle přidal do metody, která je volána z Application_Start metody v Souboru Global.asax, jak je znázorněno v příkladu Ignore(String) přetížení.

Poznámky

Tato metoda vytvoří trasu, která je namapována na obslužnou rutinu StopRoutingHandler trasy. Po volání této metody se požadavky, které odpovídají zadanému vzoru adresy URL, nezpracují jako požadavky směrování.

ASP.NET směrování automaticky ignoruje požadavky, pokud adresa URL odpovídá fyzickému souboru, například souboru obrázku. V některých případech můžete také chtít, aby směrování ignorovaly požadavky, když neexistuje žádný fyzický soubor. Například požadavky, které ASP.NET automaticky provádí pro soubory .axd, by neměly být považovány za požadavky směrování, i když neexistuje žádný fyzický soubor, který by odpovídal příponě názvu souboru .axd.

Viz také

• směrování ASP.NET

Ignore(String)

Definuje vzor adresy URL, u kterého by se neměly kontrolovat shody s trasami.

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

public void Ignore (string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parametry

url

String

Vzor adresy URL, který se má ignorovat.

Příklady

Výchozí šablona pro projekty MVC používá tuto metodu k vyloučení souborů .axd ze směrování, jak je znázorněno v následujícím příkladu:

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

Poznámky

Tato metoda vytvoří trasu, která je namapována na obslužnou rutinu StopRoutingHandler trasy. Po volání této metody se požadavky, které odpovídají zadanému vzoru adresy URL, nezpracují jako požadavky směrování.

ASP.NET směrování automaticky ignoruje požadavky, pokud adresa URL odpovídá fyzickému souboru, například souboru obrázku. V některých případech můžete také chtít, aby směrování ignorovaly požadavky, když neexistuje žádný fyzický soubor. Například požadavky, které ASP.NET automaticky provádí pro soubory .axd, by neměly být považovány za požadavky směrování, i když neexistuje žádný fyzický soubor, který by odpovídal příponě názvu souboru .axd.

Viz také

• směrování ASP.NET