DataSourceSelectArguments Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Veri alındığında veriye bağlı denetimlerin veri kaynağı denetimlerinden verilerle 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: Object
DataSourceSelectArguments

Açıklamalar

Veri bağlı denetimler, bir veri kaynağı denetiminin 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 DataSourceSelectArguments sınıfını kullanır. Veriyle ilgili bu işlemler DataSourceCapabilities numaralandırması tarafından numaralandırılır. Aşağıdaki tabloda, DataSourceSelectArguments sınıfının veriyle ilgili bu işlemleri nasıl desteklediği gösterilir.

Yetenek	İ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 PerformSelect yöntemini açıkça çağırır. Bu şekilde, veri bağlı denetim isteğe bağlı olarak veri kaynağı denetiminden veri alır. Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemi bir DataSourceSelectArguments parametresi kabul ettiğinden, veri bağlama denetimi bir DataSourceSelectArguments nesnesi oluşturup yönetmekten ve veri kaynağı denetiminden veri aldığında Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemine geçirmekten sorumludur.

Bazı durumlarda, veriye bağlı denetimlerin verilerle ilgili ek özelliklere ihtiyacı olmayabilir. Bu durumda, veriye bağlı denetimler Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemine 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 veri kaynağı görünümünün CanSort özelliğini denetler ve AddSupportedCapabilities(DataSourceCapabilities) yöntemini kullanarak bir DataSourceCapabilities.Sort özelliği ekler. Ayrı bir işlem olarak, veri bağlama denetimi, Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemine geçirilen DataSourceSelectArguments nesnesinde SortExpression özelliğini ayarlayarak bir veri kaynağı denetiminden sıralanmış sonuç kümesi isteyebilir.

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

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

Önemli

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

Oluşturucular

DataSourceSelectArguments()	DataSourceSelectArguments sınıfının yeni bir varsayılan örneğini başlatır.
DataSourceSelectArguments(Int32, Int32)	DataSourceSelectArguments sınıfının belirtilen başlangıç konumu ve sayfalama senaryoları için döndürülecek satır sayısıyla yeni bir örneğini başlatır.
DataSourceSelectArguments(String, Int32, Int32)	Belirtilen sıralama ifadesi, başlangıç konumu ve disk belleği senaryoları için döndürülecek satır sayısı ile DataSourceSelectArguments sınıfının yeni bir örneğini başlatır.
DataSourceSelectArguments(String)	Belirtilen sıralama ifadesiyle DataSourceSelectArguments sınıfının yeni bir örneğini başlatır.

Özellikler

Empty	sıralama ifadesi Emptyolarak ayarlanmış bir DataSourceSelectArguments nesnesi alır.
MaximumRows	Veri alma işlemi için bir veri kaynağı denetiminin 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 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 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) yöntemi tarafından 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ı alınırken veri kaynağı denetiminin kullanması gereken başlangıç konumunu temsil eden bir değer 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)	Desteklenen özellikleri ve istenen özellikleri karşılaştırmak için kullanılan DataSourceSelectArguments örneğine bir özellik ekler.
Equals(Object)	Belirtilen DataSourceSelectArguments örneğin geçerli örneğe eşit olup olmadığını belirler.
GetHashCode()	DataSourceSelectArguments türü için karma kodu döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)	bir ExecuteSelect(DataSourceSelectArguments) işlemi 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 bir dize döndürür. (Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.

DataSourceCapabilities

Aracılığıyla paylaş