ObjectDataSourceView Kelas
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.
ObjectDataSource Mendukung kontrol dan menyediakan antarmuka untuk kontrol terikat data untuk melakukan operasi data dengan objek bisnis dan data.
public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager
public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager
type ObjectDataSourceView = class
inherit DataSourceView
interface IStateManager
Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager
- Warisan
- Penerapan
Keterangan
Kelas ObjectDataSourceView ini dimaksudkan terutama untuk digunakan oleh kontrol terikat data, dan bukan sebagai objek yang dapat diprogram dalam kode halaman.
Kelas ObjectDataSourceView mengimplementasikan fungsionalitas data untuk ObjectDataSource kontrol, termasuk Selectoperasi , , Update, Deletedan Insert , pengurutan, pemfilteran, dan manajemen pengaturan yang disimpan dalam status tampilan.
Objek ObjectDataSourceView dibuat untuk setiap instans kelas pada ObjectDataSource durasi. Panggilan ke operasi data instans kelas ditangani ObjectDataSource oleh instans ObjectDataSourceView objek . Pengembang halaman tidak mengakses instans kelas secara ObjectDataSourceView langsung. Pengembang kontrol dapat membuat kontrol data kustom dengan memperluas ObjectDataSource kelas dan ObjectDataSourceView .
Kelas ObjectDataSourceView melakukan operasi data dengan memanggil metode pada objek bisnis atau data menggunakan refleksi. Pada durasi, ObjectDataSource kontrol membuat instans jenis yang diidentifikasi oleh TypeName properti , lalu memanggil metode yang sesuai untuk operasi data. Objek yang dibuat tidak di-cache dalam memori oleh ObjectDataSourceView. Objek dibuat dan dihancurkan untuk setiap panggilan metode data. Jika metodenya adalah static
(Shared
di Visual Basic), instans tidak dibuat tetapi metode operasi data masih dipanggil.
ObjectDataSourceView tidak secara langsung diekspos ke pengembang halaman oleh ObjectDataSource kontrol. Sebaliknya, properti dan metode ObjectDataSourceView diakses melalui ObjectDataSource. Misalnya, DeleteMethodObjectDataSourceView properti diatur dengan mengatur DeleteMethod properti dari ObjectDataSource.
Mengambil Data
Operasi paling mendasar yang dilakukan tampilan sumber data adalah pengambilan data dari penyimpanan data yang mendasar IEnumerable menggunakan Select metode , yang mengambil kumpulan item data. Metode pengambilan data, properti, dan peristiwa berikut diimplementasikan oleh ObjectDataSourceView objek dan diekspos langsung oleh kontrolnya ObjectDataSource kepada pengembang halaman dan penelepon lainnya:
Metode Select
Properti SelectMethod
Properti SelectParameters
Peristiwa Selecting
Peristiwa Selected
Memperbarui data
Objek ObjectDataSourceView mendukung pembaruan data dengan memanggil metode objek bisnis atau data yang diidentifikasi oleh UpdateMethod properti . Kontrol terikat data yang secara otomatis melakukan pembaruan, seperti GridView kontrol dan DetailsView , meneruskan parameternya dalam IOrderedDictionary antarmuka ke ObjectDataSourceView dan objek tampilan menggabungkan parameter ini dengan parameter apa pun yang ditemukan dalam UpdateParameters koleksi.
Metode pembaruan, properti, dan peristiwa berikut diimplementasikan oleh ObjectDataSourceView dan diekspos langsung oleh kontrolnya ObjectDataSource kepada pengembang halaman dan penelepon lainnya:
Metode Update
Properti UpdateMethod
Properti UpdateParameters
Peristiwa Updating
Peristiwa Updated
Menyisipkan data
Objek ObjectDataSourceView mendukung penyisipan baris data baru dengan memanggil metode objek bisnis atau data yang diidentifikasi oleh InsertMethod properti . Kontrol terikat data yang secara otomatis melakukan penyisipan, seperti GridView dan DetailsView, meneruskan parameternya dalam IOrderedDictionary antarmuka ke ObjectDataSourceView dan objek tampilan menggabungkan parameter ini dengan parameter apa pun yang ditemukan dalam InsertParameters koleksi.
Metode sisipan, properti, dan peristiwa berikut diimplementasikan oleh ObjectDataSourceView dan diekspos langsung oleh kontrolnya ObjectDataSource kepada pengembang halaman dan penelepon lainnya:
Metode Insert
Properti InsertMethod
Properti InsertParameters
Peristiwa Inserting
Peristiwa Inserted
Menghapus data
Objek ObjectDataSourceView mendukung penghapusan data dengan memanggil metode objek bisnis atau data yang diidentifikasi oleh DeleteMethod properti . Kontrol terikat data yang secara otomatis melakukan penghapusan, seperti GridView dan DetailsView, meneruskan parameternya dalam IOrderedDictionary antarmuka ke ObjectDataSourceView dan objek tampilan menggabungkan parameter ini dengan parameter apa pun yang ditemukan dalam DeleteParameters koleksi. Metode penghapusan, properti, dan peristiwa berikut diimplementasikan oleh ObjectDataSourceView dan diekspos langsung oleh kontrolnya ObjectDataSource kepada pengembang halaman dan penelepon lainnya:
Metode Delete
Properti DeleteMethod
Properti DeleteParameters
Peristiwa Deleting
Peristiwa Deleted
Memfilter dan Mengurutkan Data
Pengambilan data lebih kuat ketika Anda dapat memfilter data secara dinamis. Pemfilteran hanya didukung oleh ObjectDataSource kontrol jika Select metode mengembalikan DataTable objek atau DataSet . Anda dapat menggunakan FilterExpression properti dan FilterParameters untuk menerapkan pemfilteran dinamis ke pengambilan data. Properti ini diimplementasikan oleh ObjectDataSourceView objek dan diekspos langsung oleh kontrolnya ObjectDataSource ke kontrol terikat data dan pemanggil lainnya.
Anda dapat mengurutkan data yang Anda ambil dengan dengan ObjectDataSource mengurutkan data dalam memori setelah diambil. Pengurutan hanya didukung oleh ObjectDataSource kontrol jika Select metode mengembalikan DataTable atau DataSet. Properti CanSort selalu mengembalikan true
, karena ObjectDataSourceView tidak dapat menentukan jenis apa yang dikembalikan oleh Select metode tanpa memanggil metode . Sintaks SortExpression properti sama dengan properti DataView.Sort .
Status Tampilan Pelacakan
mengimplementasikan ObjectDataSourceViewIStateManager antarmuka dan menggunakan status tampilan untuk melacak statusnya di seluruh permintaan halaman. LoadViewStateImplementasi metode , SaveViewState, dan TrackViewState disediakan untuk mengaktifkan pelacakan status tampilan untuk kontrol. Untuk informasi selengkapnya, lihat Ringkasan Manajemen Status ASP.NET.
Konstruktor
ObjectDataSourceView(ObjectDataSource, String, HttpContext) |
Menginisialisasi instans baru kelas ObjectDataSourceView. |
Properti
CanDelete |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek yang terkait dengan kontrol saat ini ObjectDataSource mendukung operasi penghapusan. |
CanInsert |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek yang terkait dengan kontrol saat ini ObjectDataSource mendukung operasi penyisipan. |
CanPage |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek yang terkait dengan kontrol saat ini ObjectDataSource mendukung paging melalui data yang diambil. |
CanRetrieveTotalRowCount |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek yang terkait dengan kontrol saat ini ObjectDataSource mendukung pengambilan jumlah total baris data, selain kumpulan data. |
CanSort |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek yang terkait dengan kontrol saat ini ObjectDataSource mendukung tampilan yang diurutkan pada sumber data yang mendasar. |
CanUpdate |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek yang terkait dengan kontrol saat ini ObjectDataSource mendukung operasi pembaruan. |
ConflictDetection |
Mendapatkan atau menetapkan nilai yang menentukan bagaimana ObjectDataSource kontrol melakukan pembaruan dan penghapusan saat data berturut-turut dalam penyimpanan data yang mendasar berubah selama waktu operasi. |
ConvertNullToDBNull |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah Parameter nilai yang diteruskan ke operasi pembaruan, sisipkan, atau hapus secara otomatis dikonversi dari |
DataObjectTypeName |
Mendapatkan atau mengatur nama kelas yang ObjectDataSource digunakan kontrol untuk parameter dalam operasi data. Kontrol ObjectDataSource menggunakan kelas yang ditentukan alih-alih Parameter objek yang berada dalam berbagai koleksi parameter. |
DeleteMethod |
Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSourceView dipanggil objek untuk menghapus data. |
DeleteParameters |
Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh DeleteMethod metode . |
EnablePaging |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol sumber data mendukung paging melalui kumpulan data yang diambilnya. |
Events |
Mendapatkan daftar delegasi penanganan aktivitas untuk tampilan sumber data. (Diperoleh dari DataSourceView) |
FilterExpression |
Mendapatkan atau mengatur ekspresi pemfilteran yang diterapkan saat metode objek bisnis yang diidentifikasi oleh SelectMethod properti dipanggil. |
FilterParameters |
Mendapatkan kumpulan parameter yang terkait dengan tempat penampung parameter apa pun yang ada dalam FilterExpression string. |
InsertMethod |
Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSourceView dipanggil objek untuk menyisipkan data. |
InsertParameters |
Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh InsertMethod metode . |
IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah ObjectDataSourceView objek menyimpan perubahan pada status tampilannya. |
MaximumRowsParameterName |
Mendapatkan atau mengatur nama parameter metode pengambilan data yang digunakan untuk menunjukkan jumlah rekaman yang akan diambil untuk dukungan penomoran halaman sumber data. |
Name |
Mendapatkan nama tampilan sumber data. (Diperoleh dari DataSourceView) |
OldValuesParameterFormatString |
Mendapatkan atau mengatur string format untuk diterapkan ke nama parameter untuk nilai asli yang diteruskan ke |
ParsingCulture |
Mendapatkan atau menetapkan nilai yang menunjukkan informasi budaya apa yang digunakan saat mengonversi nilai string ke jenis properti aktual untuk membangun objek dari jenis yang ditunjukkan oleh DataObjectTypeName. |
SelectCountMethod |
Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSourceView dipanggil kontrol untuk mengambil jumlah baris. |
SelectMethod |
Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSourceView dipanggil kontrol untuk mengambil data. |
SelectParameters |
Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh SelectMethod metode . |
SortParameterName |
Mendapatkan atau mengatur nama parameter metode pengambilan data yang digunakan untuk menentukan ekspresi pengurutan untuk dukungan pengurutan sumber data. |
StartRowIndexParameterName |
Mendapatkan atau mengatur nama parameter metode pengambilan data yang digunakan untuk menunjukkan indeks bilangan bulat dari rekaman pertama yang diambil dari kumpulan hasil untuk dukungan halaman sumber data. |
TypeName |
Mendapatkan atau mengatur nama kelas yang diwakili ObjectDataSource kontrol. |
UpdateMethod |
Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSourceView dipanggil objek untuk memperbarui data. |
UpdateParameters |
Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh UpdateMethod metode . |
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 dengan memanggil metode objek bisnis yang diidentifikasi oleh DeleteMethod properti menggunakan koleksi dan |
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 DeleteMethod metode dan yang ditentukan |
ExecuteInsert(IDictionary) |
Melakukan operasi penyisipan dengan memanggil metode objek bisnis yang diidentifikasi oleh InsertMethod properti menggunakan koleksi yang ditentukan |
ExecuteSelect(DataSourceSelectArguments) |
Mengambil data dari objek yang diidentifikasi oleh properti dengan TypeName memanggil metode yang diidentifikasi oleh SelectMethod properti dan meneruskan nilai apa pun dalam SelectParameters koleksi. |
ExecuteUpdate(IDictionary, IDictionary, IDictionary) |
Melakukan operasi pembaruan dengan memanggil metode yang diidentifikasi oleh UpdateMethod properti dan menggunakan parameter apa pun yang disediakan dalam |
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 dengan memanggil metode objek bisnis yang diidentifikasi oleh InsertMethod properti menggunakan koleksi yang ditentukan |
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(ObjectDataSourceStatusEventArgs) |
Menaikkan Deleted peristiwa setelah ObjectDataSourceView objek menyelesaikan operasi penghapusan. |
OnDeleting(ObjectDataSourceMethodEventArgs) |
Menaikkan Deleting peristiwa sebelum ObjectDataSourceView objek mencoba operasi penghapusan. |
OnFiltering(ObjectDataSourceFilteringEventArgs) |
Menaikkan Filtering peristiwa sebelum ObjectDataSourceView objek mencoba operasi pemfilteran. |
OnInserted(ObjectDataSourceStatusEventArgs) |
Menaikkan Inserted peristiwa setelah ObjectDataSourceView objek menyelesaikan operasi penyisipan. |
OnInserting(ObjectDataSourceMethodEventArgs) |
Menaikkan Inserting peristiwa sebelum ObjectDataSourceView objek mencoba operasi sisipkan. |
OnObjectCreated(ObjectDataSourceEventArgs) |
ObjectCreated Menaikkan peristiwa setelah ObjectDataSourceView membuat instans objek yang diidentifikasi oleh TypeName properti . |
OnObjectCreating(ObjectDataSourceEventArgs) |
ObjectCreating Menaikkan peristiwa sebelum ObjectDataSourceView objek membuat instans objek bisnis untuk melakukan operasi data. |
OnObjectDisposing(ObjectDataSourceDisposingEventArgs) |
Menaikkan ObjectDisposing peristiwa sebelum ObjectDataSourceView objek membuang jenis yang dibuat. |
OnSelected(ObjectDataSourceStatusEventArgs) |
Menaikkan Selected peristiwa setelah ObjectDataSourceView objek menyelesaikan operasi pengambilan data. |
OnSelecting(ObjectDataSourceSelectingEventArgs) |
Menaikkan Selecting peristiwa sebelum ObjectDataSourceView objek mencoba operasi pengambilan data. |
OnUpdated(ObjectDataSourceStatusEventArgs) |
Menaikkan Updated peristiwa setelah ObjectDataSourceView objek menyelesaikan operasi pembaruan. |
OnUpdating(ObjectDataSourceMethodEventArgs) |
Menaikkan Updating peristiwa sebelum ObjectDataSourceView objek mencoba operasi pembaruan. |
RaiseUnsupportedCapabilityError(DataSourceCapabilities) |
Dipanggil oleh RaiseUnsupportedCapabilitiesError(DataSourceView) metode untuk membandingkan kemampuan yang ExecuteSelect(DataSourceSelectArguments) diminta untuk operasi dengan yang didukung tampilan. (Diperoleh dari DataSourceView) |
SaveViewState() |
Menyimpan perubahan ke status tampilan untuk ObjectDataSourceView objek 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 objek yang diidentifikasi oleh properti dengan TypeName memanggil metode yang diidentifikasi oleh SelectMethod properti dan meneruskan nilai apa pun dalam SelectParameters koleksi. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
TrackViewState() |
ObjectDataSourceView Menyebabkan objek melacak perubahan pada status tampilannya sehingga perubahan dapat disimpan dalam ViewState 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 dengan memanggil metode yang diidentifikasi oleh UpdateMethod properti dan menggunakan parameter apa pun yang disediakan dalam |
Acara
DataSourceViewChanged |
Terjadi ketika tampilan sumber data telah berubah. (Diperoleh dari DataSourceView) |
Deleted |
Terjadi ketika Delete operasi telah selesai. |
Deleting |
Terjadi sebelum Delete operasi. |
Filtering |
Terjadi sebelum operasi filter. |
Inserted |
Terjadi ketika Insert operasi telah selesai. |
Inserting |
Terjadi sebelum Insert operasi. |
ObjectCreated |
Terjadi setelah ObjectDataSourceView objek membuat instans jenis yang diidentifikasi oleh TypeName properti . |
ObjectCreating |
Terjadi sebelum ObjectDataSourceView objek membuat instans jenis yang diidentifikasi oleh TypeName properti . |
ObjectDisposing |
Terjadi ketika ObjectDataSourceView objek membuang instans objek yang telah dibuatnya. |
Selected |
Terjadi ketika operasi pengambilan data telah selesai. |
Selecting |
Terjadi sebelum operasi pengambilan data. |
Updated |
Terjadi ketika Update operasi telah selesai. |
Updating |
Terjadi sebelum Update operasi. |
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(). |