SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metode

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

Mengambil data dari database yang mendasar menggunakan SelectCommand string SQL dan parameter apa pun yang ada 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

Objek yang DataSourceSelectArguments digunakan 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 halaman atau pengurutan melalui data yang diambil, tetapi kontrol sumber data tidak mendukung kemampuan yang diminta.

-atau-

Penembolokan diaktifkan tetapi DataSourceMode properti sumber data tidak diatur ke DataSet.

-atau-

Properti SortParameterName diatur tetapi CommandType tidak diatur ke StoredProcedure.

InvalidOperationException

Sumber data tidak dapat membuat koneksi database.

-atau-

Penembolokan diaktifkan tetapi cache internal dan jenis perintah tidak cocok.

Keterangan

Kelas SqlDataSourceView mengimplementasikan metode yang diwariskan ExecuteSelect untuk mengambil data dari database. Pengembang halaman dan penulis kontrol terikat data tidak memanggil ExecuteSelect metode secara langsung; sebagai gantinya, gunakan metode yang diekspos Select secara publik.

Sebelum pengambilan data dilakukan, OnSelecting metode dipanggil untuk menaikkan Selecting peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai parameter dan melakukan praproscesing sebelum data diambil.

Untuk melakukan operasi, SqlDataSourceView objek membangun DbCommand objek menggunakan SelectCommand teks dan semua yang terkait SelectParameters, dan menjalankannya terhadap database yang mendasar. Setelah operasi selesai, OnSelected metode dipanggil untuk menaikkan Selected peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai pengembalian, kode kesalahan, dan melakukan pasca-pemrosesan.

Metode ExecuteSelect mengembalikan DataView objek jika DataSourceMode diatur ke DataSet, atau IDataReader objek jika DataSourceMode diatur ke DataReader. IDataReader Tutup objek setelah Anda selesai membaca data.

DataSourceMode Jika diatur ke DataSet dan penembolokan diaktifkan, SqlDataSourceView mengambil data dari dan menyimpan data ke cache selama operasi data. Cache dibuat, dibuang, atau disegarkan berdasarkan perilaku penembolokan yang ditentukan oleh kombinasi CacheDuration properti dan CacheExpirationPolicy .

Penting

Saat Anda menggunakan peniruan klien di bawah autentikasi Windows, data di-cache saat pengguna pertama mengakses data. Jika pengguna lain meminta data yang sama, data diambil dari cache. Data tidak diambil dengan melakukan panggilan lain ke database untuk memverifikasi akses pengguna ke data. Jika Anda mengharapkan beberapa pengguna mengakses data, dan Anda ingin setiap pengambilan data diverifikasi oleh konfigurasi keamanan database, jangan gunakan penembolokan.

DataSourceMode Jika diatur ke DataSet dan FilterExpression telah ditentukan, itu dievaluasi bersama dengan yang disediakan FilterParameters dan filter yang dihasilkan diterapkan ke daftar data selama operasi pengambilan data.

Lihat juga

• Select(DataSourceSelectArguments)
• SelectParameters
• SelectCommand