RouteCollection.Ignore Yöntem

Tanım

Ad Alanı:

System.Web.Routing

Bütünleştirilmiş Kod:

System.Web.dll

Yollara karşı eşleşmeler için denetlenmemesi gereken bir URL deseni tanımlar.

Aşırı Yüklemeler

Ignore(String, Object)	İstek URL'si belirtilen kısıtlamaları karşılıyorsa yollara karşı eşleşmeler için denetlenmemesi gereken bir URL deseni tanımlar.
Ignore(String)	Yollara karşı eşleşmeler için denetlenmemesi gereken bir URL deseni tanımlar.

Açıklamalar

Bu yöntem, yol işleyicisine StopRoutingHandler eşlenen bir yol oluşturur. Bu yöntemi çağırdıktan sonra, belirtilen URL deseni ile eşleşen istekler yol isteği olarak işlenmez.

ASP.NET yönlendirme, URL görüntü dosyası gibi bir fiziksel dosyayla eşleştiğinde istekleri otomatik olarak yoksayar. Bazı durumlarda, fiziksel dosya olmadığında yönlendirmenin istekleri yoksaymasını da isteyebilirsiniz. Örneğin, ASP.NET .axd dosyaları için otomatik olarak yaptığı istekler, .axd dosya adı uzantısına karşılık gelen fiziksel bir dosya olmasa bile yol istekleri olarak değerlendirilmemelidir.

Ignore(String, Object)

İstek URL'si belirtilen kısıtlamaları karşılıyorsa yollara karşı eşleşmeler için denetlenmemesi gereken bir URL deseni tanımlar.

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)

Parametreler

url

String

Yoksayılacak URL düzeni.

constraints

Object

URL deseni ile eşleşen bir isteğin yoksayılıp yoksayılmayacağını belirleyen ek ölçütler.

Özel durumlar

ArgumentNullException

url parametresidirnull.

Örnekler

Aşağıdaki örnekte, .aspx uzantısına sahip tüm URL'leri yoksaymak için bu yöntemin nasıl kullanılacağı gösterilmektedir. ".aspx" uzantısına sahip dosyaların tüm URL'lerini işlemek üzere özel bir HTTP işleyicisi kaydederseniz bunu yapmak isteyebilirsiniz. Tüm .aspx istekleriyle eşleşen tek bir URL düzeni için gibi {*path}.aspx/{*pathinfo}iki catchall parametresi gerekir. (Bu düzen, sorgu dizesi parametrelerine sahip olanlar da dahil olmak üzere .aspx biten tüm URL'lerle eşleşir.) Ancak yönlendirme, sonunda yalnızca bir catchall parametresine izin verir. Alternatif olarak, tüm URL'lerle eşleşen tek bir catchall parametresine sahip bir URL deseni belirtebilir ve ardından aşağıdaki örnekte gösterildiği gibi .aspx uzantısına sahip olmayan her şeyi dışlayan kısıtlamalar belirtebilirsiniz:

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

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

Önceki kod satırı genellikle aşırı yükleme örneğinde gösterildiği gibi Global.asax içindeki yönteminden Application_Start çağrılan bir yönteme Ignore(String) eklenir.

Açıklamalar

Bu yöntem, yol işleyicisine StopRoutingHandler eşlenen bir yol oluşturur. Bu yöntemi çağırdıktan sonra, belirtilen URL deseni ile eşleşen istekler yol isteği olarak işlenmez.

ASP.NET yönlendirme, URL görüntü dosyası gibi bir fiziksel dosyayla eşleştiğinde istekleri otomatik olarak yoksayar. Bazı durumlarda, fiziksel dosya olmadığında yönlendirmenin istekleri yoksaymasını da isteyebilirsiniz. Örneğin, ASP.NET .axd dosyaları için otomatik olarak yaptığı istekler, .axd dosya adı uzantısına karşılık gelen fiziksel bir dosya olmasa bile yol istekleri olarak değerlendirilmemelidir.

Ayrıca bkz.

• ASP.NET Yönlendirme

Ignore(String)

Yollara karşı eşleşmeler için denetlenmemesi gereken bir URL deseni tanımlar.

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

public void Ignore (string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parametreler

url

String

Yoksayılacak URL düzeni.

Örnekler

MVC projeleri için varsayılan şablon, aşağıdaki örnekte gösterildiği gibi .axd dosyalarını yönlendirmenin dışında tutmak için bu yöntemi kullanır:

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

Açıklamalar

Bu yöntem, yol işleyicisine StopRoutingHandler eşlenen bir yol oluşturur. Bu yöntemi çağırdıktan sonra, belirtilen URL deseni ile eşleşen istekler yol isteği olarak işlenmez.

ASP.NET yönlendirme, URL görüntü dosyası gibi bir fiziksel dosyayla eşleştiğinde istekleri otomatik olarak yoksayar. Bazı durumlarda, fiziksel dosya olmadığında yönlendirmenin istekleri yoksaymasını da isteyebilirsiniz. Örneğin, ASP.NET .axd dosyaları için otomatik olarak yaptığı istekler, .axd dosya adı uzantısına karşılık gelen fiziksel bir dosya olmasa bile yol istekleri olarak değerlendirilmemelidir.

Ayrıca bkz.

• ASP.NET Yönlendirme