SqlDataSourceView.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 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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParameter
- arguments
- DataSourceSelectArguments
Objek yang DataSourceSelectArguments digunakan 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 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.
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.
