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 koleksiyondaki parametrelerle SelectParameters tanımlanan yöntemini çağırarak temel alınan veri depolama alanından veri 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ı listesi.
Örnekler
Kod örneği için bkz ObjectDataSource. .
Açıklamalar
Belirtilen yöntemin herhangi bir yöntem imzası olabilir, ancak denetimin başarıyla ç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 | ile 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 özellik 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, ObjectDataSourceView özelliği tarafından tanımlanan nesnenin bir örneğini oluşturmak için yansıma kullanır TypeName . 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. Dönüş değerlerini, çıkış parametrelerini ve özel durumları 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 , bunun yerine doğrudan veri bağlı denetimi tarafından çağrılır.