Bagikan melalui


DataSourceSelectArguments Kelas

Definisi

Menyediakan mekanisme yang digunakan kontrol terikat data untuk meminta operasi terkait data dari kontrol sumber data saat data diambil. Kelas ini tidak dapat diwariskan.

public ref class DataSourceSelectArguments sealed
public sealed class DataSourceSelectArguments
type DataSourceSelectArguments = class
Public NotInheritable Class DataSourceSelectArguments
Warisan
DataSourceSelectArguments

Keterangan

Kontrol terikat data menggunakan DataSourceSelectArguments kelas untuk meminta agar kontrol sumber data melakukan operasi terkait data tambahan pada kumpulan hasil, seperti mengurutkan data atau mengembalikan subset data tertentu. Operasi terkait data ini dijumlahkan oleh DataSourceCapabilities enumerasi. Tabel berikut menunjukkan bagaimana DataSourceSelectArguments kelas mendukung operasi terkait data ini.

Kemampuan Properti DataSourceSelectArguments terkait
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCount

Kontrol terikat data secara eksplisit memanggil PerformSelect metode untuk mengikat data, yang memanggil Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode kontrol sumber data yang terkait dengannya. Dengan cara ini, kontrol terikat data mengambil data dari kontrol sumber data sesuai permintaan. Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Karena metode menerima DataSourceSelectArguments parameter, kontrol terikat data bertanggung jawab untuk membuat dan mengelola DataSourceSelectArguments objek dan meneruskannya ke Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode ketika mengambil data dari kontrol sumber data.

Dalam beberapa kasus, kontrol terikat data mungkin tidak memerlukan kemampuan terkait data tambahan. Dalam hal ini, kontrol terikat data meneruskan Empty objek argumen ke Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode .

Untuk kumpulan hasil yang diurutkan, kontrol terikat data memeriksa properti tampilan CanSort sumber data pada durasi, dan menambahkan DataSourceCapabilities.Sort kemampuan menggunakan metode .AddSupportedCapabilities(DataSourceCapabilities) Sebagai operasi terpisah, kontrol terikat data dapat meminta kumpulan hasil yang diurutkan dari kontrol sumber data dengan mengatur SortExpression properti pada objek yang DataSourceSelectArguments diteruskan ke Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode .

Untuk skenario paging, kontrol terikat data memeriksa properti tampilan CanPage sumber data pada durasi, dan menambahkan DataSourceCapabilities.Page kemampuan menggunakan metode .AddSupportedCapabilities(DataSourceCapabilities) Sebagai operasi terpisah, kontrol terikat data dapat meminta subset data dari kontrol sumber data untuk halaman dengan mengatur StartRowIndex properti dan MaximumRows pada objek yang DataSourceSelectArguments diteruskan ke Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode .

Untuk mengambil jumlah baris total untuk skenario paging, kontrol terikat data memeriksa properti tampilan CanRetrieveTotalRowCount sumber data pada durasi, dan menambahkan DataSourceCapabilities.RetrieveTotalRowCount kemampuan menggunakan AddSupportedCapabilities(DataSourceCapabilities) metode . Sebagai operasi terpisah, kontrol terikat data dapat meminta jumlah baris total dari kontrol sumber data untuk halaman dengan mengatur RetrieveTotalRowCount properti pada objek yang DataSourceSelectArguments diteruskan ke Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode . Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Saat metode kembali, jumlah baris total dimuat oleh TotalRowCount properti .

Penting

Jika salah DataSourceSelectArguments satu properti diatur, tetapi kontrol sumber data yang saat ini terikat tidak mendukung kemampuan yang InvalidOperationException diminta, pengecualian dilemparkan saat DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) metode dipanggil.

Konstruktor

DataSourceSelectArguments()

Menginisialisasi instans default baru kelas DataSourceSelectArguments .

DataSourceSelectArguments(Int32, Int32)

Menginisialisasi instans DataSourceSelectArguments baru kelas dengan posisi awal yang ditentukan dan jumlah baris yang akan dikembalikan untuk skenario penomoran halaman.

DataSourceSelectArguments(String)

Menginisialisasi instans DataSourceSelectArguments baru kelas dengan ekspresi pengurutan yang ditentukan.

DataSourceSelectArguments(String, Int32, Int32)

Menginisialisasi instans DataSourceSelectArguments baru kelas dengan ekspresi pengurutan, posisi awal, dan jumlah baris yang akan dikembalikan untuk skenario penomoran halaman.

Properti

Empty

DataSourceSelectArguments Mendapatkan objek dengan ekspresi pengurutan diatur ke Empty.

MaximumRows

Mendapatkan atau menetapkan nilai yang mewakili jumlah maksimum baris data yang dikembalikan kontrol sumber data untuk operasi pengambilan data.

RetrieveTotalRowCount

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol sumber data harus mengambil hitungan semua baris data selama operasi pengambilan data.

SortExpression

Mendapatkan atau mengatur ekspresi yang digunakan tampilan sumber data untuk mengurutkan data yang diambil oleh Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metode .

StartRowIndex

Mendapatkan atau menetapkan nilai yang mewakili posisi awal yang harus digunakan kontrol sumber data saat mengambil baris data selama operasi pengambilan data.

TotalRowCount

Mendapatkan atau mengatur jumlah baris yang diambil selama operasi pengambilan data.

Metode

AddSupportedCapabilities(DataSourceCapabilities)

Menambahkan satu kemampuan ke DataSourceSelectArguments instans, yang digunakan untuk membandingkan kemampuan yang didukung dan kemampuan yang diminta.

Equals(Object)

Menentukan apakah instans yang ditentukan DataSourceSelectArguments sama dengan instans saat ini.

GetHashCode()

Mengembalikan kode hash untuk jenis tersebut DataSourceSelectArguments .

GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)

Membandingkan kemampuan yang ExecuteSelect(DataSourceSelectArguments) diminta untuk operasi dengan kemampuan yang didukung oleh tampilan sumber data yang ditentukan.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga