ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Yöntem
Tanım
Ö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.
ö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
Veri IEnumerable satırlarının listesi.
Özel durumlar
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.
yöntemi tarafından ExecuteSelect(DataSourceSelectArguments) döndürülen nesne bir DataSetnesnesidir, ancak koleksiyonunda Tables tablo yoktur.
-veya-
EnablePaging özelliği olarak true
ayarlanı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. .