RouteParameter Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengikat nilai segmen URL ke objek parameter.

public ref class RouteParameter : System::Web::UI::WebControls::Parameter

public class RouteParameter : System.Web.UI.WebControls.Parameter

type RouteParameter = class
    inherit Parameter

Public Class RouteParameter
Inherits Parameter

Warisan: Object

Parameter
RouteParameter

Contoh

Contoh di bagian ini memperlihatkan cara menggunakan RouteParameter objek dalam markup untuk meneruskan nilai parameter URL ke kueri yang ditentukan untuk kontrol sumber data.

Contoh berikut menunjukkan kode di halaman Global.asax yang menentukan rute yang diberi nama ProductRoute. Rute menentukan parameter URL yang diberi nama productname. Rute ini juga mendefinisikan parameter catchall opsional yang diberi nama culture, yang dapat digunakan untuk menentukan bahasa tempat deskripsi produk ditampilkan. Halaman Product.aspx menangani permintaan untuk rute ini.

Contoh berikut menunjukkan halaman Product.aspx. Halaman berisi SqlDataSource kontrol yang memiliki kueri yang memerlukan dua parameter, satu untuk nama produk dan satu untuk bahasa deskripsi produk. RouteParameter objek digunakan untuk menyediakan nilai untuk parameter kueri. Nilai parameter productname URL rute diteruskan ke parameter @productnamekueri . Nilai parameter culture URL rute diteruskan ke parameter @culturekueri . Jika URL rute tidak menyertakan parameter cultureURL, nilai default "en" digunakan.

Contoh berikut ini memperlihatkan halaman bernama ProductLinks.aspx, yang berisi hyperlink yang ditautkan ke halaman Product.aspx dengan menggunakan URL rute. Hyperlink ini menggunakan RouteUrl ekspresi untuk membuat URL rute. Tautan pertama tidak menyertakan culture parameter rute. Oleh karena itu, nilai default "en" yang ditentukan dalam RouteParameter objek untuk @culture parameter kueri akan digunakan dalam kueri. Tautan kedua memberikan culture nilai "fr", yang menyebabkan deskripsi ditampilkan dalam bahasa Prancis. Untuk informasi selengkapnya tentang cara menggunakan RouteUrl ekspresi, lihat Cara: Membuat URL dari Rute.

Saat Anda mengklik hyperlink pertama, Anda akan melihat halaman Product.aspx dengan nilai berikut dalam GridView kontrol:

ProductID	Nama	Deskripsi
`994`	`LL Bottom Bracket`	`Chromoly steel.`

Saat Anda mengklik hyperlink kedua, Anda akan melihat nilai berikut ini di GridView kontrol:

ProductID	Nama	Deskripsi
`994`	`LL Bottom Bracket`	`Acier chromé.`

Untuk menjalankan contoh ini, tambahkan dua halaman .aspx dan kode dalam file Global.asax ke situs Web ASP.NET atau aplikasi Web yang menentukan string koneksi bernama AdventureWorksLTConnectionString untuk database AdventureWorksLT. Untuk informasi tentang cara menyiapkan koneksi ke database AdventureWorksLT, lihat Cara: Menyiapkan Database Sampel AdventureWorksLT untuk pengembangan ASP.NET.

Untuk informasi selengkapnya tentang perutean ASP.NET, lihat Perutean ASP.NET.

Keterangan

Jika Anda menerapkan perutean ASP.NET di situs Web, Anda bisa menggunakan RouteParameter objek untuk mengikat nilai segmen URL yang diminta ke kueri atau perintah database. Anda dapat mendeklarasikan RouteParameter objek dalam markup untuk kontrol sumber data atau QueryExtender kontrol.

Proyek situs Web Visual Studio dengan kode sumber tersedia untuk menyertai topik ini: Unduh.

Konstruktor

RouteParameter()	Menginisialisasi instans baru kelas RouteParameter.
RouteParameter(RouteParameter)	Menginisialisasi instans RouteParameter baru kelas dengan menggunakan nilai instans yang ditentukan.
RouteParameter(String, DbType, String)	Menginisialisasi instans RouteParameter baru kelas dengan menggunakan nama dan jenis database yang ditentukan untuk parameter , dan dengan menggunakan kunci yang ditentukan untuk data rute.
RouteParameter(String, String)	Menginisialisasi instans RouteParameter baru kelas dengan menggunakan nama yang ditentukan untuk parameter dan kunci yang ditentukan untuk data rute.
RouteParameter(String, TypeCode, String)	Menginisialisasi instans RouteParameter baru kelas dengan menggunakan nama dan jenis yang ditentukan untuk parameter, dan dengan menggunakan kunci yang ditentukan untuk data rute.

Properti

ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang Parameter terikat objek harus dikonversi ke `null` jika itu adalah Empty. (Diperoleh dari Parameter)
DbType	Mendapatkan atau mengatur jenis database parameter. (Diperoleh dari Parameter)
DefaultValue	Menentukan nilai default untuk parameter , jika nilai parameter terikat untuk tidak diinisialisasi saat metode dipanggil Evaluate(HttpContext, Control) . (Diperoleh dari Parameter)
Direction	Menunjukkan apakah Parameter objek digunakan untuk mengikat nilai ke kontrol, atau kontrol dapat digunakan untuk mengubah nilai. (Diperoleh dari Parameter)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
Name	Mendapatkan atau mengatur nama parameter. (Diperoleh dari Parameter)
RouteKey	Mendapatkan atau mengatur nama segmen rute tempat mengambil nilai untuk parameter rute.
Size	Mendapatkan atau mengatur ukuran parameter. (Diperoleh dari Parameter)
Type	Mendapatkan atau mengatur jenis parameter. (Diperoleh dari Parameter)
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status Parameter tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Metode

Clone()	Mengembalikan duplikat instans saat ini RouteParameter .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Evaluate(HttpContext, Control)	Mengevaluasi URL permintaan dan mengembalikan nilai parameter.
GetDatabaseType()	Mendapatkan nilai yang setara dengan jenis CLR instans DbType saat ini Parameter . (Diperoleh dari Parameter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya dari tampilan sumber data. (Diperoleh dari Parameter)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Memanggil metode ParameterCollection koleksi yang berisi Parameter objek . (Diperoleh dari Parameter)
SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
SetDirty()	Parameter Menandai objek sehingga statusnya akan direkam dalam status tampilan. (Diperoleh dari Parameter)
ToString()	Mengonversi nilai instans ini ke representasi string yang setara. (Diperoleh dari Parameter)
TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Mengembalikan duplikat instans saat ini Parameter . (Diperoleh dari Parameter)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya dari tampilan sumber data. (Diperoleh dari Parameter)
IStateManager.SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
IStateManager.TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Berlaku untuk

Share via