SqlDataSourceView Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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.

SqlDataSource Mendukung kontrol dan menyediakan antarmuka untuk kontrol terikat data untuk melakukan operasi data SQL terhadap database relasional.

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Warisan: Object

DataSourceView
SqlDataSourceView

Turunan: System.Web.UI.WebControls.AccessDataSourceView

Penerapan: IStateManager

Keterangan

Kelas SqlDataSourceView ini dimaksudkan terutama untuk digunakan oleh kontrol terikat data, dan bukan sebagai objek yang dapat diprogram dalam kode halaman.

ASP.NET kontrol sumber data berisi satu atau beberapa daftar data, yang diwakili oleh objek tampilan sumber data. Kelas SqlDataSourceView memperluas DataSourceView kelas , menentukan kemampuan SqlDataSource kontrol yang terkait dengannya, dan mengimplementasikan fungsionalitas data dasar untuk kontrol sumber data. Kelas mengimplementasikan SqlDataSourceView fungsionalitas data untuk SqlDataSource kontrol, termasuk Selectoperasi , , Update, Insertdan Delete , pengurutan, pemfilteran, dan pengelolaan pengaturan yang disimpan dalam status tampilan.

SqlDataSourceView Meskipun objek tidak secara langsung diekspos ke pengembang halaman oleh SqlDataSource kontrol, banyak propertinya. Operasi paling mendasar yang dilakukan tampilan sumber data adalah pengambilan data dari database yang mendasar IEnumerable menggunakan Select metode , yang mengambil kumpulan item data. Kelas menerapkan SqlDataSourceView pengambilan data dari database relasional menggunakan kueri SQL. Kueri SQL dapat diparameterkan untuk fleksibilitas dan keamanan yang lebih besar. Metode pengambilan data, properti, dan peristiwa berikut diimplementasikan oleh SqlDataSourceView dan diekspos langsung oleh kontrolnya SqlDataSource kepada pengembang halaman dan penelepon lainnya:

Properti SelectCommand
Properti SelectParameters
Peristiwa Selecting
Peristiwa Selected

Objek SqlDataSourceView mendukung pembaruan data dalam database relasional menggunakan perintah SQL. Perintah SQL dapat diparameterkan untuk fleksibilitas dan keamanan yang lebih besar. Kontrol terikat data, seperti GridView dan DetailsView, dapat dikonfigurasi untuk melakukan pembaruan secara otomatis menggunakan SqlDataSourceView, sementara kontrol lain tidak dapat. Metode pembaruan, properti, dan peristiwa berikut diimplementasikan oleh SqlDataSourceView dan diekspos langsung oleh kontrolnya SqlDataSource kepada pengembang halaman dan penelepon lainnya:

Properti UpdateCommand
Properti UpdateParameters
Peristiwa Updating
Peristiwa Updated

Mendukung SqlDataSourceView penyisipan baris data baru ke dalam database relasional. Perintah SQL yang ditentukan dalam InsertCommand properti dapat diparameterkan untuk fleksibilitas dan keamanan yang lebih besar. Kontrol terikat data, seperti GridView dan DetailsView, dapat dikonfigurasi untuk melakukan penyisipan secara otomatis menggunakan SqlDataSourceView, sementara kontrol lain tidak dapat. Metode sisipan, properti, dan peristiwa berikut diimplementasikan oleh SqlDataSourceView dan diekspos langsung oleh kontrolnya SqlDataSource kepada pengembang halaman dan penelepon lainnya:

Properti InsertCommand
Properti InsertParameters
Peristiwa Inserting
Peristiwa Inserted

Objek SqlDataSourceView ini juga mendukung penghapusan data dari database relasional. Seperti halnya perintah lain, perintah SQL yang ditentukan dalam DeleteCommand properti dapat diparameterkan untuk fleksibilitas dan keamanan yang lebih besar. Kontrol terikat data, seperti GridView dan DetailsView, dapat dikonfigurasi untuk melakukan penghapusan secara otomatis menggunakan SqlDataSourceView, sementara kontrol lain tidak dapat. Metode penghapusan, properti, dan peristiwa berikut diimplementasikan oleh SqlDataSourceView dan diekspos langsung oleh kontrolnya SqlDataSource kepada pengembang halaman dan penelepon lainnya:

Properti DeleteCommand
Properti DeleteParameters
Peristiwa Deleting
Peristiwa Deleted

Pengambilan data lebih kuat ketika klausa yang digunakan untuk memfilter data selama pengambilan data bersifat dinamis. Dengan kata lain, kueri SQL dengan klausa WHERE statis tidak fleksibel dan kuat seperti kueri SQL di mana nilai dalam klausa WHERE terikat ke nilai yang dapat berubah, seperti nilai yang ditampilkan dalam kontrol di halaman Formulir Web. Alih-alih membangun kembali kueri SQL dan mengatur SelectCommand properti pada setiap pemuatan halaman, Anda dapat menggunakan FilterExpression properti dan FilterParameters untuk menerapkan pemfilteran dinamis ke pengambilan data. Properti ini diimplementasikan oleh SqlDataSourceView dan diekspos langsung oleh kontrolnya SqlDataSource ke kontrol terikat data dan pemanggil lainnya.

Anda dapat mengurutkan data yang Anda ambil dengan kontrol dengan SqlDataSource menambahkan klausa ORDER BY, yang menyebabkan database melakukan pengurutan untuk Anda saat Anda mengambil data atau dengan mengurutkan data dalam memori setelah diambil. Anda dapat memberikan ekspresi pengurutan ke SqlDataSourceView dengan mengatur SortExpression properti DataSourceSelectArguments objek yang diteruskan ke Select metode . Sintaks untuk SortExpression properti sama dengan sintaks untuk DataView.Sort properti . Jika Anda menggunakan prosedur tersimpan untuk mengambil data, Anda juga dapat menggunakan SortParameterName properti untuk menentukan parameter yang digunakan khusus untuk mengurutkan hasil panggilan prosedur tersimpan.

Ketika lebih dari satu pengguna dapat mengubah database secara bersamaan, ada potensi konflik konkurensi. Kontrol SqlDataSource memiliki konkurensi kontrol melalui SqlDataSource.ConflictDetection properti . Fungsionalitas diimplementasikan dalam SqlDataSourceView.ConflictDetection properti .

Seperti banyak kontrol server Web lainnya, SqlDataSourceView mengimplementasikan IStateManager antarmuka dan menggunakan status tampilan untuk melacak statusnya di seluruh permintaan halaman. IsTrackingViewState Implementasi properti dan dan LoadViewStatemetode , SaveViewState, dan TrackViewState disediakan untuk mengaktifkan pelacakan status tampilan untuk kontrol. Untuk informasi selengkapnya, lihat Ringkasan Manajemen Status ASP.NET.

Konstruktor

SqlDataSourceView(SqlDataSource, String, HttpContext)

Menginisialisasi instans baru dari SqlDataSourceView pengaturan kelas kontrol yang ditentukan SqlDataSource sebagai pemilik tampilan saat ini.

Properti

CancelSelectOnNullParameter	Mendapatkan atau menetapkan nilai yang menunjukkan apakah operasi pengambilan data dibatalkan ketika parameter apa pun yang terkandung dalam SelectParameters koleksi dievaluasi ke `null`.
CanDelete	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek yang terkait dengan kontrol saat ini SqlDataSource mendukung operasi penghapusan.
CanInsert	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek yang terkait dengan kontrol saat ini SqlDataSource mendukung operasi penyisipan.
CanPage	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek yang terkait dengan kontrol saat ini SqlDataSource mendukung halaman data yang diambil.
CanRetrieveTotalRowCount	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek yang terkait dengan kontrol saat ini SqlDataSource mendukung pengambilan jumlah total baris data, selain kumpulan data.
CanSort	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek yang terkait dengan kontrol saat ini SqlDataSource mendukung tampilan yang diurutkan pada data yang diambil.
CanUpdate	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek yang terkait dengan kontrol saat ini SqlDataSource mendukung operasi pembaruan.
ConflictDetection	Mendapatkan atau mengatur nilai yang menunjukkan bagaimana SqlDataSource kontrol melakukan pembaruan dan penghapusan saat data dalam baris dalam database yang mendasar berubah selama waktu operasi.
DeleteCommand	Mendapatkan atau mengatur string SQL yang SqlDataSourceView digunakan untuk menghapus data dari database yang mendasar.
DeleteCommandType	Mendapatkan atau menetapkan nilai yang menunjukkan apakah teks dalam DeleteCommand properti adalah pernyataan SQL atau nama prosedur tersimpan.
DeleteParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh DeleteCommand properti .
Events	Mendapatkan daftar delegasi penanganan aktivitas untuk tampilan sumber data. (Diperoleh dari DataSourceView)
FilterExpression	Mendapatkan atau mengatur ekspresi pemfilteran yang diterapkan saat Select metode dipanggil.
FilterParameters	Mendapatkan kumpulan parameter yang terkait dengan tempat penampung parameter apa pun dalam FilterExpression string.
InsertCommand	Mendapatkan atau mengatur string SQL yang SqlDataSourceView digunakan objek untuk menyisipkan data ke dalam database yang mendasar.
InsertCommandType	Mendapatkan atau menetapkan nilai yang menunjukkan apakah teks dalam InsertCommand properti adalah pernyataan SQL atau nama prosedur tersimpan.
InsertParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh InsertCommand properti .
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah SqlDataSourceView objek menyimpan perubahan pada status tampilannya.
Name	Mendapatkan nama tampilan sumber data. (Diperoleh dari DataSourceView)
OldValuesParameterFormatString	Mendapatkan atau mengatur string format untuk diterapkan ke nama parameter apa pun yang diteruskan ke Delete metode atau Update .
ParameterPrefix	Mendapatkan string yang digunakan untuk mengawali tempat penampung parameter dalam kueri SQL berparameter.
SelectCommand	Mendapatkan atau mengatur string SQL yang SqlDataSourceView digunakan objek untuk mengambil data dari database yang mendasar.
SelectCommandType	Mendapatkan atau menetapkan nilai yang menunjukkan apakah teks dalam SelectCommand properti adalah kueri SQL atau nama prosedur tersimpan.
SelectParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh SelectCommand properti .
SortParameterName	Mendapatkan atau mengatur nama parameter prosedur tersimpan yang digunakan untuk mengurutkan data yang diambil saat pengambilan data dilakukan menggunakan prosedur tersimpan.
UpdateCommand	Mendapatkan atau mengatur string SQL yang SqlDataSourceView digunakan objek untuk memperbarui data dalam database yang mendasar.
UpdateCommandType	Mendapatkan atau menetapkan nilai yang menunjukkan apakah teks dalam UpdateCommand properti adalah pernyataan SQL atau nama prosedur tersimpan.
UpdateParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh UpdateCommand properti .

Metode

CanExecute(String)	Menentukan apakah perintah yang ditentukan dapat dijalankan. (Diperoleh dari DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Melakukan operasi penghapusan asinkron pada daftar data yang diwakili DataSourceView objek. (Diperoleh dari DataSourceView)
Delete(IDictionary, IDictionary)	Melakukan operasi penghapusan menggunakan DeleteCommand string SQL, parameter apa pun yang ditentukan dalam DeleteParameters koleksi, dan nilai yang ada dalam koleksi dan `oldValues` yang ditentukan`keys`.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Menjalankan perintah yang ditentukan. (Diperoleh dari DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Menjalankan perintah yang ditentukan. (Diperoleh dari DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Melakukan operasi penghapusan menggunakan DeleteCommand string SQL, parameter apa pun yang ditentukan dalam DeleteParameters koleksi, dan nilai yang ada dalam koleksi dan `oldValues` yang ditentukan`keys`.
ExecuteInsert(IDictionary)	Melakukan operasi penyisipan menggunakan InsertCommand string SQL, parameter apa pun yang ditentukan dalam InsertParameters koleksi, dan nilai yang ada dalam koleksi yang ditentukan `values` .
ExecuteSelect(DataSourceSelectArguments)	Mengambil data dari database yang mendasar menggunakan SelectCommand string SQL dan parameter apa pun yang ada dalam SelectParameters koleksi.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Melakukan operasi pembaruan menggunakan UpdateCommand string SQL, parameter apa pun yang ada dalam UpdateParameters koleksi, dan nilai yang ada dalam koleksi , , `values`dan `oldValues` yang ditentukan`keys`.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Melakukan operasi penyisipan asinkron pada daftar data yang diwakili DataSourceView objek. (Diperoleh dari DataSourceView)
Insert(IDictionary)	Melakukan operasi penyisipan menggunakan InsertCommand string SQL, parameter apa pun yang ditentukan dalam InsertParameters koleksi, dan nilai yang ada dalam koleksi yang ditentukan `values` .
LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya untuk tampilan sumber data.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnDataSourceViewChanged(EventArgs)	Memunculkan kejadian DataSourceViewChanged. (Diperoleh dari DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Menaikkan Deleted peristiwa setelah SqlDataSource kontrol menyelesaikan operasi penghapusan.
OnDeleting(SqlDataSourceCommandEventArgs)	Menaikkan Deleting peristiwa sebelum SqlDataSource kontrol mencoba operasi penghapusan.
OnFiltering(SqlDataSourceFilteringEventArgs)	Filtering Menaikkan peristiwa sebelum SqlDataSource kontrol memfilter hasil operasi pilih.
OnInserted(SqlDataSourceStatusEventArgs)	Menaikkan Inserted peristiwa setelah SqlDataSource kontrol menyelesaikan operasi penyisipan.
OnInserting(SqlDataSourceCommandEventArgs)	Menaikkan Inserting peristiwa sebelum SqlDataSource kontrol mencoba operasi sisipkan.
OnSelected(SqlDataSourceStatusEventArgs)	Menaikkan Selected peristiwa setelah SqlDataSource kontrol menyelesaikan operasi pengambilan data.
OnSelecting(SqlDataSourceSelectingEventArgs)	Selecting Menaikkan peristiwa sebelum SqlDataSource kontrol mencoba operasi pengambilan data.
OnUpdated(SqlDataSourceStatusEventArgs)	Menaikkan Updated peristiwa setelah SqlDataSource kontrol menyelesaikan operasi pembaruan.
OnUpdating(SqlDataSourceCommandEventArgs)	Menaikkan Updating peristiwa sebelum SqlDataSource kontrol mencoba operasi pembaruan.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Membandingkan kemampuan yang diminta untuk ExecuteSelect(DataSourceSelectArguments) operasi terhadap kemampuan yang didukung tampilan dan dipanggil oleh RaiseUnsupportedCapabilitiesError(DataSourceView) metode .
SaveViewState()	Menyimpan perubahan ke status tampilan untuk SqlDataSourceView kontrol sejak halaman diposting kembali ke server.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Mendapatkan daftar data secara asinkron dari penyimpanan data yang mendasar. (Diperoleh dari DataSourceView)
Select(DataSourceSelectArguments)	Mengambil data dari database yang mendasar menggunakan SelectCommand string SQL dan parameter apa pun yang ada dalam SelectParameters koleksi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TrackViewState()	SqlDataSourceView Menyebabkan objek melacak perubahan pada status tampilannya sehingga perubahan dapat disimpan dalam StateBag objek untuk kontrol dan bertahan di seluruh permintaan untuk halaman yang sama.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Melakukan operasi pembaruan asinkron pada daftar data yang diwakili DataSourceView objek. (Diperoleh dari DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Melakukan operasi pembaruan menggunakan UpdateCommand string SQL, parameter apa pun yang ada dalam UpdateParameters koleksi, dan nilai yang ada dalam koleksi , , `values`dan `oldValues` yang ditentukan`keys`.

Acara

DataSourceViewChanged	Terjadi ketika tampilan sumber data telah berubah. (Diperoleh dari DataSourceView)
Deleted	Terjadi ketika operasi penghapusan telah selesai.
Deleting	Terjadi sebelum operasi penghapusan.
Filtering	Terjadi sebelum operasi filter.
Inserted	Terjadi ketika operasi penyisipan telah selesai.
Inserting	Terjadi sebelum operasi penyisipan.
Selected	Terjadi ketika operasi pengambilan data telah selesai.
Selecting	Terjadi sebelum operasi pengambilan data.
Updated	Terjadi ketika operasi pembaruan telah selesai.
Updating	Terjadi sebelum operasi pembaruan.

Implementasi Antarmuka Eksplisit

IStateManager.IsTrackingViewState	Untuk deskripsi anggota ini, lihat IsTrackingViewState.
IStateManager.LoadViewState(Object)	Untuk deskripsi anggota ini, lihat LoadViewState(Object).
IStateManager.SaveViewState()	Untuk deskripsi anggota ini, lihat SaveViewState().
IStateManager.TrackViewState()	Untuk deskripsi anggota ini, lihat TrackViewState().

Berlaku untuk

Bagikan melalui