SqlDataSourceView.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.
SQL dizesini ve koleksiyondaki parametreleri kullanarak SelectCommand temel alınan veritabanından SelectParameters 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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParametreler
- arguments
- DataSourceSelectArguments
DataSourceSelectArguments Temel veri alma işleminin ötesinde veriler üzerinde işlem istemek için kullanılan nesne.
Döndürülenler
Veri IEnumerable satırları 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 çalışmalar gerçekleştirmesi gerektiğini belirtir, ancak veri kaynağı denetimi istenen özelliği desteklemez.
-veya-
Önbelleğe alma etkin ancak DataSourceMode veri kaynağının özelliği olarak DataSetayarlanmadı.
-veya-
SortParameterName özelliği ayarlanır, ancak CommandType olarak StoredProcedureayarlanmaz.
Veri kaynağı veritabanı bağlantısı oluşturamıyor.
-veya-
Önbelleğe alma etkinleştirilir, ancak iç önbellek ve komut türleri eşleşmiyor.
Açıklamalar
sınıfı, SqlDataSourceView veritabanından veri almak için devralınan ExecuteSelect yöntemi uygular. Sayfa geliştiricileri ve veriye bağlı denetim yazarları doğrudan yöntemini çağırmaz ExecuteSelect ; bunun yerine genel kullanıma sunulan Select yöntemi kullanın.
Veri alma işlemi gerçekleştirilmeden önce, OnSelecting olayı yükseltmek için yöntemi çağrılır Selecting . Bu olayı, parametrelerin değerlerini incelemek ve veriler alınmadan önce herhangi bir ön işleme gerçekleştirmek için işleyebilirsiniz.
İşlemi gerçekleştirmek için nesnesi, SqlDataSourceView metni ve ilişkili DbCommandherhangi bir öğesini kullanarak SelectCommand bir SelectParameters nesne oluşturur ve bunu temel alınan veritabanında 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, hata kodlarını inceleyebilir ve işlem sonrası işlemleri gerçekleştirebilirsiniz.
ExecuteSelect yöntemi, olarak ayarlanırsa DataViewDataSourceMode bir DataSet nesne veya olarak ayarlanmışsa IDataReaderDataSourceModebir DataReader nesne döndürür. IDataReader Verileri okumayı bitirdiğinizde nesneyi kapatın.
DataSourceMode olarak ayarlanırsa DataSet ve önbelleğe alma etkinleştirilirse, SqlDataSourceView veri işlemi sırasında verileri önbellekten alır ve önbelleğe kaydeder. Önbellek, ve CacheDuration özelliklerinin birleşimi CacheExpirationPolicy tarafından belirtilen önbelleğe alma davranışına göre oluşturulur, atılır veya yenilenir.
Important
Windows authentication altında istemci kimliğe bürünme özelliğini kullandığınızda, veriler ilk kullanıcı verilere eriştiğinde önbelleğe alınır. Başka bir kullanıcı aynı verileri isterse, veriler önbellekten alınır. Veriler, kullanıcının verilere erişimini doğrulamak için veritabanına başka bir çağrı yapılarak alınmaz. Verilere birden çok kullanıcının erişmesini bekliyorsanız ve her veri alımının veritabanının güvenlik yapılandırmaları tarafından doğrulanmasını istiyorsanız önbelleğe almayı kullanmayın.
DataSourceMode olarak ayarlanırsa DataSet ve belirtildiyseFilterExpression, sağlanan FilterParameters tüm filtrelerle birlikte değerlendirilir ve sonuçta elde edilen filtre, veri alma işlemi sırasında veri listesine uygulanır.
