ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metode
Definisi
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.
Mengambil data dari objek yang diidentifikasi oleh TypeName properti dengan memanggil metode yang diidentifikasi oleh SelectMethod properti dan meneruskan nilai apa pun dalam SelectParameters koleksi.
protected public:
override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParameter
- arguments
- DataSourceSelectArguments
digunakan DataSourceSelectArguments untuk meminta operasi pada data di luar pengambilan data dasar.
Mengembalikan
Daftar IEnumerable baris data.
Pengecualian
Yang arguments diteruskan ke ExecuteSelect(DataSourceSelectArguments) metode menentukan bahwa sumber data harus melakukan beberapa pekerjaan tambahan saat mengambil data untuk mengaktifkan penomoran atau pengurutan melalui data yang diambil, tetapi kontrol sumber data tidak mendukung kemampuan yang diminta.
-atau-
Objek yang ExecuteSelect(DataSourceSelectArguments) dikembalikan oleh metode bukan DataSet atau DataTable, dan penembolokan diaktifkan. Hanya DataSet objek dan DataTable dapat di-cache untuk ObjectDataSourceView kontrol.
-atau-
Penembolokan dan peniruan klien diaktifkan. ObjectDataSource tidak mendukung penembolokan ketika peniruan klien diaktifkan.
Objek yang ExecuteSelect(DataSourceSelectArguments) dikembalikan oleh metode adalah DataSet, tetapi tidak memiliki tabel dalam koleksinya Tables .
-atau-
Properti EnablePaging diatur ke true, tetapi StartRowIndexParameterName properti dan MaximumRowsParameterName tidak diatur.
Keterangan
Kelas ObjectDataSourceView mengimplementasikan metode yang diwariskan ExecuteSelect untuk mengambil data menggunakan objek bisnis. Pengembang halaman dan penulis kontrol terikat data tidak memanggil ExecuteSelect metode secara langsung; sebagai gantinya, gunakan metode yang diekspos Select secara publik.
Metode yang ditentukan dapat memiliki tanda tangan metode apa pun, tetapi harus mengembalikan salah satu jenis untuk ObjectDataSource kontrol yang tercantum dalam tabel berikut agar berhasil memanggilnya.
| Tipe hasil | Tindakan |
|---|---|
| IEnumerable | IEnumerable dikembalikan oleh Select metode . |
| DataTable | DataView dibuat menggunakan DataTable dan dikembalikan oleh Select metode . |
| DataSet | Yang pertama DataTableDataSet diekstraksi dan DataView dibuat dan dikembalikan oleh Select metode . |
| Object | Objek dibungkus dalam satu elemen IEnumerable dan dikembalikan oleh Select metode . |
Sebelum pengambilan data dilakukan, OnSelecting metode dipanggil untuk menaikkan Selecting peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai parameter dan melakukan praproscessing sebelum operasi.
Untuk melakukan operasi pilih, ObjectDataSourceView kontrol menggunakan pantulan untuk memanggil metode yang diidentifikasi oleh SelectMethod properti dan parameter terkait yang ada dalam SelectParameters koleksi, lalu menjalankannya. Setelah operasi selesai, metode dipanggil OnSelected untuk menaikkan Selected peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai pengembalian dan kode kesalahan apa pun, dan untuk melakukan pasca-pemrosesan.
Select Jika metode mengembalikan DataSet objek dan penembolokan diaktifkan, mengambil ObjectDataSourceView data dari dan menyimpan data ke cache selama operasi. Cache dibuat, dibuang, atau disegarkan berdasarkan perilaku penembolokan yang ditentukan oleh kombinasi CacheDuration properti dan CacheExpirationPolicy .
Select Jika metode mengembalikan DataSet objek dan FilterExpression properti telah ditentukan, metode dievaluasi bersama dengan properti yang disediakan FilterParameters dan filter yang dihasilkan diterapkan ke daftar data selama Select operasi.
Untuk informasi tentang mengembalikan jumlah baris yang dipilih, lihat Select.
