RouteCollection.Ignore Metode

Definisi

Ruang nama:

System.Web.Routing

Rakitan:

System.Web.dll

Menentukan pola URL yang tidak boleh diperiksa untuk kecocokan terhadap rute.

Overload

Ignore(String, Object)	Menentukan pola URL yang tidak boleh diperiksa kecocokan dengan rute jika URL permintaan memenuhi batasan yang ditentukan.
Ignore(String)	Menentukan pola URL yang tidak boleh diperiksa untuk kecocokan terhadap rute.

Keterangan

Metode ini membuat rute yang dipetakan ke StopRoutingHandler penangan rute. Setelah Anda memanggil metode ini, permintaan yang cocok dengan pola URL yang ditentukan tidak akan diproses sebagai permintaan rute.

ASP.NET perutean secara otomatis mengabaikan permintaan saat URL cocok dengan file fisik, seperti file gambar. Dalam beberapa kasus, Anda mungkin juga ingin perutean mengabaikan permintaan ketika tidak ada file fisik. Misalnya, permintaan yang ASP.NET secara otomatis membuat file .axd tidak boleh diperlakukan sebagai permintaan rute meskipun tidak ada file fisik yang sesuai dengan ekstensi nama file .axd.

Ignore(String, Object)

Menentukan pola URL yang tidak boleh diperiksa kecocokan dengan rute jika URL permintaan memenuhi batasan yang ditentukan.

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

url

String

Pola URL yang akan diabaikan.

constraints

Object

Kriteria tambahan yang menentukan apakah permintaan yang cocok dengan pola URL akan diabaikan.

Pengecualian

ArgumentNullException

Parameternya url adalah null.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini untuk mengabaikan semua URL yang memiliki ekstensi .aspx. Anda mungkin ingin melakukan ini jika Anda mendaftarkan handler HTTP kustom untuk menangani semua URL untuk file yang memiliki ekstensi ".aspx". Pola URL tunggal yang akan cocok dengan semua permintaan .aspx akan memerlukan dua parameter catchall seperti {*path}.aspx/{*pathinfo}. (Pola ini akan cocok dengan URL apa pun yang berakhiran .aspx, termasuk yang memiliki parameter string kueri.) Namun, perutean hanya memungkinkan satu parameter catchall di akhir. Sebagai alternatif, Anda dapat menentukan pola URL yang memiliki parameter catchall tunggal yang cocok dengan semua URL lalu menentukan batasan yang mengecualikan semua yang tidak memiliki ekstensi .aspx, seperti yang ditunjukkan dalam contoh berikut:

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

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

Baris kode sebelumnya biasanya akan ditambahkan ke metode yang dipanggil dari Application_Start metode di Global.asax, seperti yang ditunjukkan dalam contoh untuk Ignore(String) kelebihan beban.

Keterangan

Metode ini membuat rute yang dipetakan ke StopRoutingHandler penangan rute. Setelah Anda memanggil metode ini, permintaan yang cocok dengan pola URL yang ditentukan tidak akan diproses sebagai permintaan rute.

ASP.NET perutean secara otomatis mengabaikan permintaan saat URL cocok dengan file fisik, seperti file gambar. Dalam beberapa kasus, Anda mungkin juga ingin perutean mengabaikan permintaan ketika tidak ada file fisik. Misalnya, permintaan yang ASP.NET secara otomatis membuat file .axd tidak boleh diperlakukan sebagai permintaan rute meskipun tidak ada file fisik yang sesuai dengan ekstensi nama file .axd.

Lihat juga

• Perutean ASP.NET

Ignore(String)

Menentukan pola URL yang tidak boleh diperiksa untuk kecocokan terhadap rute.

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

public void Ignore (string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parameter

url

String

Pola URL yang akan diabaikan.

Contoh

Templat default untuk proyek MVC menggunakan metode ini untuk mengecualikan file .axd dari perutean, seperti yang ditunjukkan dalam contoh berikut:

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

Keterangan

Metode ini membuat rute yang dipetakan ke StopRoutingHandler penangan rute. Setelah Anda memanggil metode ini, permintaan yang cocok dengan pola URL yang ditentukan tidak akan diproses sebagai permintaan rute.

ASP.NET perutean secara otomatis mengabaikan permintaan saat URL cocok dengan file fisik, seperti file gambar. Dalam beberapa kasus, Anda mungkin juga ingin perutean mengabaikan permintaan ketika tidak ada file fisik. Misalnya, permintaan yang ASP.NET secara otomatis membuat file .axd tidak boleh diperlakukan sebagai permintaan rute meskipun tidak ada file fisik yang sesuai dengan ekstensi nama file .axd.

Lihat juga

• Perutean ASP.NET