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 alımının ötesinde veriler üzerinde işlem istemek için kullanılan bir nesne.
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-
Önbelleğe alma etkinleştirildi, 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ştirildi, 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ı yöntemi doğrudan ç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 SelectParametersherhangi bir öğesini kullanarak SelectCommand bir DbCommand 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 ayarlandıysa DataSourceMode bir DataView nesne veya olarak ayarlanmışsa DataReaderDataSetDataSourceMode bir IDataReader 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 CacheExpirationPolicy özelliklerinin birleşimi CacheDuration tarafından belirtilen önbelleğe alma davranışına göre oluşturulur, atılır veya yenilenir.
Önemli
Windows kimlik doğrulaması 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 FilterExpression belirtildiyse, sağlanan FilterParameters herhangi bir değerle birlikte değerlendirilir ve sonuçta elde edilen filtre, veri alma işlemi sırasında veri listesine uygulanır.
