Share via

SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parametreler

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

IEnumerable

Veri IEnumerable satırlarının listesi.

Özel durumlar

NotSupportedException

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.

InvalidOperationException

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.

Şunlara uygulanır

Ayrıca bkz.