ObjectDataSource.Select Yöntem

Tanım

ö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.

Şunlara uygulanır

Ayrıca bkz.