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

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: Object

DataSourceView
ObjectDataSourceView

Penerapan: IStateManager

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, DeleteMethod ObjectDataSourceView 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 ObjectDataSourceView IStateManager 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 `null` ke Value nilai.
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 `Delete` metode atau `Update` .
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)	Melakukan operasi penghapusan dengan memanggil metode objek bisnis yang diidentifikasi oleh DeleteMethod properti menggunakan koleksi dan `oldValues` yang ditentukan`keys`.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Melakukan operasi penghapusan asinkron pada daftar data yang diwakili DataSourceView objek. (Diperoleh dari DataSourceView)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExecuteCommand(String, IDictionary, IDictionary)	Menjalankan perintah yang ditentukan. (Diperoleh dari DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Menjalankan perintah yang ditentukan. (Diperoleh dari DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Melakukan operasi penghapusan menggunakan DeleteMethod metode dan yang ditentukan `keys` dan `oldValues` koleksi.
ExecuteInsert(IDictionary)	Melakukan operasi penyisipan dengan memanggil metode objek bisnis yang diidentifikasi oleh InsertMethod properti menggunakan koleksi yang ditentukan `values` .
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 `keys`koleksi , , `values`atau `oldValues` .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
Insert(IDictionary)	Melakukan operasi penyisipan dengan memanggil metode objek bisnis yang diidentifikasi oleh InsertMethod properti menggunakan koleksi yang ditentukan `values` .
Insert(IDictionary, DataSourceViewOperationCallback)	Melakukan operasi penyisipan asinkron pada daftar data yang diwakili DataSourceView objek. (Diperoleh dari DataSourceView)
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)	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.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Mendapatkan daftar data secara asinkron dari penyimpanan data yang mendasar. (Diperoleh dari DataSourceView)
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)	Melakukan operasi pembaruan dengan memanggil metode yang diidentifikasi oleh UpdateMethod properti dan menggunakan parameter apa pun yang disediakan dalam `keys`koleksi , , `values`atau `oldValues` .
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Melakukan operasi pembaruan asinkron pada daftar data yang diwakili DataSourceView objek. (Diperoleh dari DataSourceView)

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().

Berlaku untuk

Share via