Aracılığıyla paylaş


DataSourceSelectArguments Sınıf

Tanım

Veriye bağlı denetimlerin veri alındığında veri kaynağı denetimlerinden veriyle ilgili işlemler istemek için kullandığı bir mekanizma sağlar. Bu sınıf devralınamaz.

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

Açıklamalar

Veriye bağlı denetimler, bir veri kaynağı denetiminin DataSourceSelectArguments bir sonuç kümesinde verileri sıralama veya belirli bir veri alt kümesini döndürme gibi verilerle ilgili ek işlemler gerçekleştirmesini istemek için sınıfını kullanır. Bu veriyle ilgili işlemler, numaralandırma tarafından DataSourceCapabilities numaralandırılır. Aşağıdaki tabloda sınıfın veriyle DataSourceSelectArguments ilgili bu işlemleri nasıl desteklediği gösterilir.

Özellik İlgili DataSourceSelectArguments özellikleri
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCount

Veriye bağlı denetimler, ilişkili oldukları veri kaynağı denetiminin Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemini çağıran verileri bağlamak için yöntemini açıkça çağırırPerformSelect. Bu şekilde, veriye bağlı denetim isteğe bağlı olarak veri kaynağı denetiminden verileri alır. Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemi bir DataSourceSelectArguments parametre kabul ettiğinden, veriye bağlı denetim bir DataSourceSelectArguments nesne oluşturup yönetmekten ve veri Select(DataSourceSelectArguments, DataSourceViewSelectCallback) kaynağı denetiminden veri aldığında yöntemine geçirmekten sorumludur.

Bazı durumlarda, veriye bağlı denetimlerin verilerle ilgili ek özelliklere ihtiyacı olmayabilir. Bu durumda, veriye bağlı denetimler yöntemine Select(DataSourceSelectArguments, DataSourceViewSelectCallback) bir Empty bağımsız değişken nesnesi geçirir.

Sıralanmış sonuç kümeleri için, veriye bağlı denetimler çalışma zamanında bir veri kaynağı görünümünün CanSort özelliğini denetler ve yöntemini kullanarak AddSupportedCapabilities(DataSourceCapabilities) bir DataSourceCapabilities.Sort özellik ekler. Ayrı bir işlem olarak, veriye bağlı denetim yöntemine geçirilen Select(DataSourceSelectArguments, DataSourceViewSelectCallback) nesnede DataSourceSelectArguments özelliğini ayarlayarak SortExpression bir veri kaynağı denetiminden sıralanmış sonuç kümesi isteyebilir.

Disk belleği senaryoları için, veriye bağlı denetimler çalışma zamanında bir veri kaynağı görünümünün CanPage özelliğini denetler ve yöntemini kullanarak AddSupportedCapabilities(DataSourceCapabilities) bir DataSourceCapabilities.Page özellik ekler. Ayrı bir işlem olarak, veriye bağlı denetim, yöntemine geçirilen Select(DataSourceSelectArguments, DataSourceViewSelectCallback) nesnede DataSourceSelectArguments ve MaximumRows özelliklerini ayarlayarak StartRowIndex disk belleği için bir veri kaynağı denetiminden bir veri alt kümesi isteyebilir.

Disk belleği senaryolarının toplam satır sayısını almak için, veriye bağlı denetimler çalışma zamanında bir veri kaynağı görünümünün CanRetrieveTotalRowCount özelliğini denetler ve yöntemini kullanarak AddSupportedCapabilities(DataSourceCapabilities) bir DataSourceCapabilities.RetrieveTotalRowCount özellik ekler. Ayrı bir işlem olarak, veriye bağlı denetim yöntemine geçirilen Select(DataSourceSelectArguments, DataSourceViewSelectCallback) nesnede DataSourceSelectArguments özelliğini ayarlayarak RetrieveTotalRowCount disk belleği için bir veri kaynağı denetiminden toplam satır sayısı isteyebilir. Yöntemi döndürdüğünde Select(DataSourceSelectArguments, DataSourceViewSelectCallback) , toplam satır sayısı özelliği tarafından TotalRowCount kapsanan.

Önemli

Özelliklerden DataSourceSelectArguments herhangi biri ayarlanırsa, ancak şu anda bağlı olan veri kaynağı denetimi istenen özelliği desteklemiyorsa, yöntem çağrıldığında DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) bir InvalidOperationException özel durum oluşturulur.

Oluşturucular

DataSourceSelectArguments()

sınıfının yeni bir varsayılan örneğini DataSourceSelectArguments başlatır.

DataSourceSelectArguments(Int32, Int32)

Belirtilen başlangıç konumu ve disk belleği senaryoları için döndürülecek satır sayısıyla sınıfının yeni bir örneğini DataSourceSelectArguments başlatır.

DataSourceSelectArguments(String)

Belirtilen sıralama ifadesiyle sınıfının yeni bir örneğini DataSourceSelectArguments başlatır.

DataSourceSelectArguments(String, Int32, Int32)

Belirtilen sıralama ifadesi, başlangıç konumu ve sayfalama senaryoları için döndürülecek satır sayısı ile sınıfının yeni bir örneğini DataSourceSelectArguments başlatır.

Özellikler

Empty

Sıralama ifadesi olarak ayarlanmış Emptybir DataSourceSelectArguments nesne alır.

MaximumRows

Bir veri kaynağı denetiminin bir veri alma işlemi için döndürdüğü en fazla veri satırı sayısını temsil eden bir değer alır veya ayarlar.

RetrieveTotalRowCount

Veri alma işlemi sırasında bir veri kaynağı denetiminin tüm veri satırlarının sayısını alıp almayacağını belirten bir değer alır veya ayarlar.

SortExpression

Veri kaynağı görünümünün yöntemi tarafından Select(DataSourceSelectArguments, DataSourceViewSelectCallback) alınan verileri sıralamak için kullandığı bir ifadeyi alır veya ayarlar.

StartRowIndex

Veri alma işlemi sırasında veri satırlarını alırken veri kaynağı denetiminin kullanması gereken başlangıç konumunu temsil eden bir değeri alır veya ayarlar.

TotalRowCount

Veri alma işlemi sırasında alınan satır sayısını alır veya ayarlar.

Yöntemler

AddSupportedCapabilities(DataSourceCapabilities)

Örneğe DataSourceSelectArguments , desteklenen özellikleri ve istenen özellikleri karşılaştırmak için kullanılan bir özellik ekler.

Equals(Object)

Belirtilen DataSourceSelectArguments örneğin geçerli örneğe eşit olup olmadığını belirler.

GetHashCode()

Türün karma kodunu DataSourceSelectArguments döndürür.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)

Bir ExecuteSelect(DataSourceSelectArguments) işlem için istenen özellikleri, belirtilen veri kaynağı görünümünün desteklediği özelliklerle karşılaştırır.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.