ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.dll

özelliği tarafından tanımlanan yöntemini çağırarak ve koleksiyondaki TypeNameSelectParameters değerleri geçirerek özelliği tarafından SelectMethod tanımlanan nesneden veri alır.

protected public:
 override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);

protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);

override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parametreler

arguments

DataSourceSelectArguments

DataSourceSelectArguments Temel veri alma işlemlerinin ötesinde veriler üzerinde işlem istemek için kullanılır.

Döndürülenler

IEnumerable

Veri IEnumerable satırlarının listesi.

Özel durumlar

NotSupportedException

arguments yöntemine ExecuteSelect(DataSourceSelectArguments) geçirilen veri kaynağının, alınan veriler arasında sayfalama veya sıralamayı etkinleştirmek için verileri alırken bazı ek işler gerçekleştirmesi gerektiğini belirtir, ancak veri kaynağı denetimi istenen özelliği desteklemez.

-veya-

yöntemi tarafından ExecuteSelect(DataSourceSelectArguments) döndürülen nesne veya DataTabledeğil DataSet ve önbelleğe alma etkin. Denetim için ObjectDataSourceView yalnızca DataSet ve DataTable nesneleri önbelleğe alınabiliyor.

-veya-

Hem önbelleğe alma hem de istemci kimliğe bürünme etkindir. , ObjectDataSource istemci kimliğe bürünme etkinleştirildiğinde önbelleğe almayı desteklemez.

InvalidOperationException

yöntemi tarafından ExecuteSelect(DataSourceSelectArguments) döndürülen nesne bir DataSetnesnesidir, ancak koleksiyonunda Tables tablo yoktur.

-veya-

EnablePaging özelliği olarak trueayarlanır, ancak StartRowIndexParameterName ve MaximumRowsParameterName özellikleri ayarlanmaz.

Açıklamalar

sınıfı, ObjectDataSourceView bir iş nesnesi kullanarak verileri almak için devralınan ExecuteSelect yöntemi uygular. Sayfa geliştiricileri ve veriye bağlı denetim yazarları yöntemi doğrudan çağırmaz ExecuteSelect ; bunun yerine genel kullanıma sunulan Select yöntemi kullanın.

Belirtilen yöntemin herhangi bir yöntem imzası olabilir, ancak başarılı bir şekilde çağırmak için ObjectDataSource aşağıdaki tabloda listelenen denetim türlerinden birini döndürmesi gerekir.

Dönüş türü	Eylem
IEnumerable	IEnumerable yöntemi tarafından Select döndürülür.
DataTable	yöntemi DataView tarafından Select döndürülen ve kullanılarak DataTable oluşturulur.
DataSet	öğesinin ilki DataTableDataSet ayıklanır ve yöntemi tarafından Select oluşturulur DataView ve döndürülür.
Object	Nesnesi tek öğeli IEnumerable bir şekilde sarmalanır ve yöntemi tarafından Select döndürülür.

Veri alma işlemi gerçekleştirilmeden önce, OnSelecting olayı yükseltmek için yöntemi çağrılır Selecting . Parametrelerin değerlerini incelemek ve bir işlemden önce herhangi bir ön işleme gerçekleştirmek için bu olayı işleyebilirsiniz.

Bir seçme işlemi gerçekleştirmek için denetim, ObjectDataSourceView özelliği tarafından SelectMethod tanımlanan yöntemi ve koleksiyondaki SelectParameters ilişkili parametreleri çağırmak için yansımayı kullanır ve ardından onu yürütür. İşlem tamamlandıktan sonra, OnSelected olayı yükseltmek için yöntemi çağrılır Selected . Bu olayı işleyerek dönüş değerlerini ve hata kodlarını inceleyebilir ve işlem sonrası işlemleri gerçekleştirebilirsiniz.

Select Yöntem bir DataSet nesne döndürürse ve önbelleğe alma etkinleştirilirse, ObjectDataSourceView öğesinden veri alır ve işlem sırasında verileri önbelleğe kaydeder. Önbellek, ve CacheExpirationPolicy özelliklerinin birleşimi CacheDuration tarafından belirtilen önbelleğe alma davranışına göre oluşturulur, atılır veya yenilenir.

Select Yöntem bir DataSet nesne döndürürse ve bir FilterExpression özellik belirtilmişse, sağlanan FilterParameters özelliklerle birlikte değerlendirilir ve sonuçta elde edilen filtre işlem sırasında Select veri listesine uygulanır.

Seçilen satır sayısını döndürme hakkında bilgi için bkz Select. .

Ayrıca bkz.

• Select(DataSourceSelectArguments)
• SelectMethod
• SelectCountMethod
• OnSelecting(ObjectDataSourceSelectingEventArgs)
• OnSelected(ObjectDataSourceStatusEventArgs)
• Selecting
• Selected