Bagikan melalui


SqlDataSourceView Kelas

Definisi

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
SqlDataSourceView
Turunan
Penerapan

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:

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:

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:

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:

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

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

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 , , valuesdan oldValues yang ditentukankeys.

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 , , valuesdan oldValues yang ditentukankeys.

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

Lihat juga