ObjectDataSource.Select 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 SelectMethod tanımlanan yöntemini koleksiyondaki parametrelerle çağırarak temel alınan veri depolama alanından SelectParameters verileri alır.
public:
System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable
Döndürülenler
Veri IEnumerable satırlarının listesi.
Örnekler
Kod örneği için bkz ObjectDataSource. .
Açıklamalar
Belirtilen yöntemin herhangi bir yöntem imzası olabilir, ancak denetimin başarılı bir şekilde çağırması için aşağıdaki tabloda listelenen türlerden birini döndürmesi ObjectDataSource veya türetilmesi gerekir.
Dönüş türü | Eylem |
---|---|
IEnumerable | IEnumerable yöntemi tarafından Select döndürülür. |
DataTable | kullanılarak DataView oluşturulur DataTable ve yöntemi tarafından Select döndürülür. |
DataView | DataView yöntemi tarafından Select döndürülür. |
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 koleksiyonda sarmalanır ve yöntemi tarafından Select döndürülür. |
özelliği tarafından SelectMethod tanımlanan yöntem bir örnek yöntemi veya static
(Shared
Visual Basic'te) yöntemi olabilir. Bu bir örnek yöntemiyse, özellik tarafından SelectMethod belirtilen yöntem her çağrıldığında iş nesnesi oluşturulur ve yok edilir, ancak özelliği tarafından belirtilen yöntemi ve özelliği tarafından SelectMethodSelectCountMethod belirtilen yöntemi çağırmak için aynı örnek kullanılır.
Select yöntemi bir IEnumerable arabirim döndürür. Ancak, önbelleğe alma ve filtreleme senaryolarını etkinleştirmek için dönüş değerinin bir DataSet nesne olması gerekir. sınıfı arabirimini IEnumerable uygulamasa da, ObjectDataSource denetim otomatik olarak öğesini uygulayan varsayılan DataView denetimi ayıklarIEnumerable.DataSet
Select İşlem gerçekleştirilmeden önce, OnSelecting olayı yükseltmek için yöntemi çağrılırSelecting. Parametrelerin Selecting değerlerini incelemek ve bir işlemden önce herhangi bir Select ön işleme gerçekleştirmek için olayı işleyebilirsiniz. Veri alma işlemi gerçekleştirmek için nesnesi yansımayı ObjectDataSourceView kullanarak özelliği tarafından tanımlanan nesnenin bir örneğini TypeName oluşturur. Ardından, ilişkili SelectParameters özellikleri kullanarak özelliği tarafından SelectMethod tanımlanan yöntemini çağırır. Select İşlem tamamlandıktan sonra, OnSelected olayı yükseltmek için yöntemi çağrılırSelected. Herhangi bir dönüş değerini, çıkış parametresini ve özel durumu incelemek ve herhangi bir işlem sonrası gerçekleştirmek için olayı işleyebilirsiniz Selected .
SelectMethod özelliği bir DataSet, DataTableveya DataView nesnesi döndürürse ve önbelleğe alma etkinleştirilirse, ObjectDataSource öğesinden veri alır ve işlem sırasında Select 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.
SelectMethod Özellik bir DataSet veya DataTable nesnesi döndürürse ve bir FilterExpression özellik belirtilmişse, sağlanan FilterParameters özelliklerle değerlendirilir ve sonuçta elde edilen filtre işlem sırasında Select veri listesine uygulanır.
yöntemi, Select denetimiyle ilişkili yöntemini ObjectDataSourceView temsil ederObjectDataSource.Select
Parametre birleştirme, nesne ömrü ve yöntem çözümlemesi hakkında daha fazla bilgi için bkz SelectMethod. .
Data-Bound Denetimleri
ObjectDataSource Denetim, denetim gibi GridView veriye bağlı bir denetimle ilişkilendirildiğinde, yöntemini sayfa kodundan çağırmak Select gerekli değildir. yöntemi Select doğrudan veriye bağlı denetim tarafından çağrılır.