ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metode

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

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.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parameter

arguments

DataSourceSelectArguments

digunakan DataSourceSelectArguments untuk meminta operasi pada data di luar pengambilan data dasar.

Mengembalikan

IEnumerable

Daftar IEnumerable baris data.

Pengecualian

NotSupportedException

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.

InvalidOperationException

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.

Lihat juga

• Select(DataSourceSelectArguments)
• SelectMethod
• SelectCountMethod
• OnSelecting(ObjectDataSourceSelectingEventArgs)
• OnSelected(ObjectDataSourceStatusEventArgs)
• Selecting
• Selected