BaseDataList.DataSourceID Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

Mendapatkan atau mengatur ID properti kontrol sumber data yang harus digunakan kontrol daftar data untuk mengambil sumber datanya.

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.Themeable(false)]
public virtual string DataSourceID { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.DataSourceID : string with get, set

Public Overridable Property DataSourceID As String

Nilai Properti

String

Pengidentifikasi terprogram yang ditetapkan ke kontrol sumber data.

Atribut

ThemeableAttribute

Pengecualian

HttpException

Sumber data tidak dapat diselesaikan karena nilai ditentukan untuk DataSource properti dan DataSourceID properti .

Keterangan

DataSourceID Gunakan properti untuk mengakses ID properti kontrol sumber data yang harus digunakan kontrol daftar data untuk mengambil sumber datanya. Kontrol sumber data yang dirujuk DataSourceID oleh properti dapat menjadi kontrol apa pun yang mengimplementasikan IDataSource antarmuka. Kontrol sumber data harus ada baik dalam kontainer penamaan yang sama dengan kontrol daftar data yang mereferensikannya, atau dalam kontrol induk kontrol daftar data. Saat Anda menentukan nilai untuk properti ini, kontrol daftar data secara otomatis mengikat kontrol sumber data yang ditentukan. Anda tidak perlu menulis kode yang secara eksplisit memanggil DataBind metode .

Secara bergantian, Anda dapat menggunakan DataSource properti untuk menentukan sumber nilai yang akan diikat ke kontrol daftar data. Sumber data harus berupa koleksi yang mengimplementasikan System.Collections.IEnumerable antarmuka (seperti System.Data.DataView, , System.Collections.ArrayListatau System.Collections.Generic.List<T>) atau IListSource antarmuka untuk mengikat kontrol yang berasal dari BaseDataList kelas . Saat mengatur DataSource properti , Anda harus menulis kode secara manual untuk melakukan pengikatan data.

Jika nilai ditentukan untuk DataSource properti dan DataSourceID properti , ASP.NET tidak dapat menyelesaikan sumber data dan System.Web.HttpException pengecualian dilemparkan.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Lihat juga

• DataSource