Bagikan melalui


ObjectDataSource.Select Metode

Definisi

Mengambil data dari penyimpanan data yang mendasar dengan memanggil metode yang diidentifikasi oleh SelectMethod properti dengan parameter dalam SelectParameters koleksi.

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

Mengembalikan

Daftar IEnumerable baris data.

Contoh

Untuk contoh kode, lihat ObjectDataSource.

Keterangan

Metode yang ditentukan mungkin memiliki tanda tangan metode apa pun, tetapi harus mengembalikan atau berasal dari salah satu jenis yang tercantum dalam tabel berikut agar ObjectDataSource kontrol berhasil memanggilnya.

Tipe hasil Tindakan
IEnumerable IEnumerable dikembalikan oleh Select metode .
DataTable DataView dibuat dengan menggunakan DataTable dan dikembalikan oleh Select metode .
DataView DataView dikembalikan oleh Select metode .
DataSet Yang pertama DataTableDataSet diekstraksi dan DataView dibuat dan dikembalikan oleh Select metode .
Object Objek dibungkus dalam koleksi satu elemen IEnumerable dan dikembalikan oleh Select metode .

Metode yang diidentifikasi oleh SelectMethod properti dapat menjadi metode instans atau static metode (Shared dalam Visual Basic). Jika ini adalah metode instans, objek bisnis dibuat dan dihancurkan setiap kali metode yang ditentukan oleh SelectMethod properti dipanggil, kecuali bahwa instans yang sama digunakan untuk memanggil metode yang ditentukan oleh SelectMethod properti dan metode yang ditentukan oleh SelectCountMethod properti . Metode mengembalikan SelectIEnumerable antarmuka. Namun, untuk mengaktifkan skenario penembolokan dan pemfilteran, nilai yang dikembalikan harus berupa DataSet objek . DataSet Meskipun kelas tidak mengimplementasikan IEnumerable antarmuka, ObjectDataSource kontrol secara otomatis mengekstrak kontrol defaultDataView, yang mengimplementasikan IEnumerable.

Select Sebelum operasi dilakukan, OnSelecting metode dipanggil untuk menaikkan Selecting peristiwa. Anda dapat menangani Selecting peristiwa untuk memeriksa nilai parameter dan melakukan praproscessing sebelum Select operasi. Untuk melakukan operasi pengambilan data, ObjectDataSourceView objek menggunakan pantulan untuk membuat instans objek yang diidentifikasi oleh TypeName properti . Kemudian memanggil metode yang diidentifikasi oleh SelectMethod properti , menggunakan properti terkait SelectParameters . Select Setelah operasi selesai, metode dipanggil OnSelected untuk menaikkan Selected peristiwa. Anda dapat menangani Selected peristiwa untuk memeriksa nilai pengembalian, parameter output, dan pengecualian apa pun, dan untuk melakukan pasca-pemrosesan.

SelectMethod Jika properti mengembalikan DataSetobjek , DataTable, atau DataView dan penembolokan diaktifkan, mengambil ObjectDataSource data dari dan menyimpan data ke cache selama Select operasi. Cache dibuat, dibuang, atau disegarkan berdasarkan perilaku penembolokan yang ditentukan oleh kombinasi CacheDuration properti dan CacheExpirationPolicy .

SelectMethod Jika properti mengembalikan DataSet objek atau DataTable , dan FilterExpression properti telah ditentukan, properti dievaluasi dengan properti yang disediakan FilterParameters dan filter yang dihasilkan diterapkan ke daftar data selama Select operasi.

Metode ini Select mendelegasikan ke Select metode ObjectDataSourceView yang terkait dengan ObjectDataSource kontrol.

Untuk informasi selengkapnya tentang penggabungan parameter, masa pakai objek, dan resolusi metode, lihat SelectMethod.

Kontrol Terikat-Data

Ketika kontrol dikaitkan ObjectDataSource dengan kontrol terikat data, seperti GridView kontrol, tidak perlu memanggil Select metode dari kode halaman. Metode Select ini dipanggil langsung oleh kontrol terikat data sebagai gantinya.

Berlaku untuk

Lihat juga