SqlDataSourceView Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

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

Denetimi destekler ve ilişkisel veritabanlarında SqlDataSource SQL veri işlemleri gerçekleştirmek için veriye bağlı denetimler için bir arabirim sağlar.

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Devralma: Object

DataSourceView
SqlDataSourceView

Türetilmiş: System.Web.UI.WebControls.AccessDataSourceView

Uygulamalar: IStateManager

Açıklamalar

SqlDataSourceView sınıfı, sayfa kodunda programlanabilir bir nesne olarak değil, öncelikle veriye bağlı denetimler tarafından kullanılmak üzere tasarlanmıştır.

ASP.NET veri kaynağı denetimleri, veri kaynağı görünümü nesneleriyle temsil edilen bir veya daha fazla veri listesi içerir. SqlDataSourceView sınıfını DataSourceView genişletir, ilişkilendirildiği denetimin SqlDataSource özelliklerini tanımlar ve veri kaynağı denetimi için temel veri işlevselliğini uygular. SqlDataSourceView sınıfı, , Update, Insertve işlemleri, sıralama, filtreleme ve Delete görüntüleme durumunda tutulan ayarları yönetme dahil olmak üzere Selectdenetim için SqlDataSource veri işlevselliğini uygular.

Nesne, denetim tarafından SqlDataSource sayfa geliştiricilerine doğrudan gösterilmese SqlDataSourceView de özelliklerinin çoğu vardır. Veri kaynağı görünümünün gerçekleştirdiği en temel işlem, veri öğeleri koleksiyonunu alan yöntemini kullanarak Select temel alınan veritabanından veri alma IEnumerable işlemidir. sınıfı, SqlDataSourceView SQL sorgularını kullanarak ilişkisel veritabanlarından veri alma işlemi uygular. SQL sorguları daha fazla esneklik ve güvenlik için parametrelendirilebilir. Aşağıdaki veri alma yöntemleri, özellikleri ve olayları tarafından uygulanır SqlDataSourceView ve doğrudan denetimi tarafından SqlDataSource sayfa geliştiricilerine ve diğer arayanlara sunulur:

özelliği SelectCommand
özelliği SelectParameters
Olay Selecting
Olay Selected

nesnesi, SqlDataSourceView SQL komutlarını kullanarak ilişkisel veritabanındaki verileri güncelleştirmeyi destekler. DAHA fazla esneklik ve güvenlik için SQL komutları parametreleştirilebilir. ve DetailsViewgibi GridView verilere bağlı denetimler, güncelleştirmeleri kullanarak SqlDataSourceViewotomatik olarak gerçekleştirecek şekilde yapılandırılabilir, ancak diğer denetimler bunu yapamaz. Aşağıdaki güncelleştirme yöntemleri, özellikleri ve olayları tarafından uygulanır SqlDataSourceView ve doğrudan denetimi tarafından SqlDataSource sayfa geliştiricilerine ve diğer arayanlara sunulur:

UpdateCommand özelliği
UpdateParameters özelliği
Olay Updating
Olay Updated

, SqlDataSourceView ilişkisel veritabanına yeni veri satırları eklemeyi destekler. özelliğinde InsertCommand belirtilen SQL komutları, daha fazla esneklik ve güvenlik için parametreleştirilebilir. ve DetailsViewgibi GridView veriye bağlı denetimler, diğer denetimler tarafından SqlDataSourceViewkullanılarak eklemeleri otomatik olarak gerçekleştirecek şekilde yapılandırılabilir. Aşağıdaki ekleme yöntemleri, özellikleri ve olayları tarafından uygulanır SqlDataSourceView ve doğrudan denetimi tarafından SqlDataSource sayfa geliştiricilerine ve diğer arayanlara sunulur:

InsertCommand özelliği
InsertParameters özelliği
Olay Inserting
Olay Inserted

Nesnesi, SqlDataSourceView ilişkisel veritabanından veri silmeyi de destekler. Diğer komutlarda olduğu gibi, özelliğinde DeleteCommand belirtilen SQL komutları daha fazla esneklik ve güvenlik için parametreleştirilebilir. ve DetailsViewgibi GridView veriye bağlı denetimler, diğer denetimler tarafından kullanılarak otomatik SqlDataSourceViewolarak silme işlemleri gerçekleştirecek şekilde yapılandırılabilir. Aşağıdaki silme yöntemleri, özellikleri ve olayları tarafından uygulanır SqlDataSourceView ve doğrudan denetimi tarafından SqlDataSource sayfa geliştiricilerine ve diğer arayanlara sunulur:

DeleteCommand özelliği
DeleteParameters özelliği
Olay Deleting
Olay Deleted

Veri alma sırasında verileri filtrelemek için kullanılan yan tümcesi dinamik olduğunda veri alma daha güçlüdür. Başka bir deyişle, statik WHERE yan tümcesine sahip bir SQL sorgusu, WHERE yan tümcesindeki değerlerin değişebilen değerlere (Web Forms sayfasındaki denetimlerde görüntülenen değerler gibi) bağlı olduğu bir SQL sorgusu kadar esnek ve güçlü değildir. Bir SQL sorgusunu yeniden derlemek ve her sayfa yükünde SelectCommand özelliğini ayarlamak yerine ve FilterParameters özelliklerini kullanarak FilterExpression veri alma işlemine dinamik filtreleme uygulayabilirsiniz. Bu özellikler, ve tarafından SqlDataSourceView uygulanır ve doğrudan denetimi tarafından SqlDataSource veriye bağlı denetimlere ve diğer çağıranlara sunulur.

Bir ORDER BY yan tümcesi ekleyerek denetimle aldığınız SqlDataSource verileri sıralayabilirsiniz. Bu, veritabanının verileri aldığınızda veya verileri alındıktan sonra bellekte sıralayarak sizin için sıralamasını sağlar. yöntemine SqlDataSourceView geçirilen Select nesnenin SortExpression DataSourceSelectArguments özelliğini ayarlayarak öğesine bir sıralama ifadesi sağlayabilirsiniz. Özelliğin SortExpression söz dizimi, özelliğin DataView.Sort söz dizimi ile aynıdır. Verileri almak için saklı yordam kullanırsanız, özellikle saklı yordam çağrısının SortParameterName sonuçlarını sıralamak için kullanılan bir parametreyi belirtmek için özelliğini de kullanabilirsiniz.

Veritabanını aynı anda birden fazla kullanıcı değiştirebildiğinde eşzamanlılık çakışması olasılığı vardır. Denetimin SqlDataSource özelliği aracılığıyla eşzamanlılığı denetlemesi SqlDataSource.ConflictDetection gerekir. İşlevsellik özelliğinde SqlDataSourceView.ConflictDetection uygulanır.

Diğer birçok Web sunucusu denetiminde olduğu gibi, SqlDataSourceView arabirimini IStateManager uygular ve sayfa istekleri arasında durumunu izlemek için görünüm durumunu kullanır. ve özelliği ile , SaveViewStateve TrackViewState yöntemlerinin IsTrackingViewState LoadViewStateuygulamaları, denetimin durum izlemesini görüntülemeyi etkinleştirmek için sağlanır. Daha fazla bilgi için bkz. ASP.NET Durum Yönetimine Genel Bakış.

Oluşturucular

SqlDataSourceView(SqlDataSource, String, HttpContext)

Geçerli görünümün SqlDataSourceView sahibi olarak belirtilen SqlDataSource denetimi ayaran sınıfın yeni bir örneğini başlatır.

Özellikler

CancelSelectOnNullParameter	Koleksiyonunda yer alan SelectParameters herhangi bir parametre olarak değerlendirildiğinde `null`veri alma işleminin iptal edilip edilmediğini belirten bir değer alır veya ayarlar.
CanDelete	Geçerli SqlDataSource denetimle ilişkili nesnenin SqlDataSourceView silme işlemini destekleyip desteklemediğini belirten bir değer alır.
CanInsert	Geçerli SqlDataSource denetimle ilişkili nesnenin SqlDataSourceView ekleme işlemini destekleyip desteklemediğini belirten bir değer alır.
CanPage	Geçerli SqlDataSource denetimle ilişkili nesnenin SqlDataSourceView alınan verilerin disk belleğini destekleyip desteklemediğini belirten bir değer alır.
CanRetrieveTotalRowCount	Geçerli SqlDataSource denetimle ilişkili nesneninSqlDataSourceView, veri kümesine ek olarak toplam veri satırı sayısını almayı destekleyip desteklemediğini belirten bir değer alır.
CanSort	Geçerli SqlDataSource denetimle ilişkili nesnenin SqlDataSourceView alınan verilerde sıralanmış bir görünümü destekleyip desteklemediğini belirten bir değer alır.
CanUpdate	Geçerli SqlDataSource denetimle ilişkili nesnenin SqlDataSourceView güncelleştirme işlemini destekleyip desteklemediğini belirten bir değer alır.
ConflictDetection	denetimin güncelleştirmeleri nasıl SqlDataSource gerçekleştirdiğini gösteren değeri alır veya ayarlar ve işlem sırasında temel alınan veritabanındaki bir satırdaki veriler değiştiğinde siler.
DeleteCommand	temel alınan veritabanından verileri silmek için kullandığı SQL dizesini SqlDataSourceView alır veya ayarlar.
DeleteCommandType	Özelliğindeki DeleteCommand metnin SQL deyimi mi yoksa saklı yordamın adı mı olduğunu belirten bir değer alır veya ayarlar.
DeleteParameters	özelliği tarafından DeleteCommand kullanılan parametreleri içeren parameters koleksiyonunu alır.
Events	Veri kaynağı görünümü için olay işleyicisi temsilcilerinin listesini alır. (Devralındığı yer: DataSourceView)
FilterExpression	Yöntem çağrıldığında Select uygulanan bir filtreleme ifadesi alır veya ayarlar.
FilterParameters	Dizedeki tüm parametre yer tutucularıyla FilterExpression ilişkili bir parametre koleksiyonunu alır.
InsertCommand	Nesnenin temel alınan veritabanına veri eklemek için kullandığı SQL dizesini SqlDataSourceView alır veya ayarlar.
InsertCommandType	Özelliğindeki InsertCommand metnin SQL deyimi mi yoksa saklı yordamın adı mı olduğunu belirten bir değer alır veya ayarlar.
InsertParameters	özelliği tarafından InsertCommand kullanılan parametreleri içeren parameters koleksiyonunu alır.
IsTrackingViewState	Nesnenin SqlDataSourceView görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.
Name	Veri kaynağı görünümünün adını alır. (Devralındığı yer: DataSourceView)
OldValuesParameterFormatString	veya yöntemine geçirilen Delete parametrelerin adlarına uygulanacak bir biçim dizesi alır veya Update ayarlar.
ParameterPrefix	Parametreli SQL sorgusunda parametre yer tutucusunun ön ekini almak için kullanılan dizeyi alır.
SelectCommand	Nesnenin temel alınan veritabanından SqlDataSourceView veri almak için kullandığı SQL dizesini alır veya ayarlar.
SelectCommandType	Özelliğindeki SelectCommand metnin sql sorgusu mu yoksa saklı yordamın adı mı olduğunu belirten bir değer alır veya ayarlar.
SelectParameters	özelliği tarafından SelectCommand kullanılan parametreleri içeren parameters koleksiyonunu alır.
SortParameterName	Saklı yordam kullanılarak veri alma işlemi gerçekleştirildiğinde alınan verileri sıralamak için kullanılan saklı yordam parametresinin adını alır veya ayarlar.
UpdateCommand	Nesnenin temel alınan veritabanındaki SqlDataSourceView verileri güncelleştirmek için kullandığı SQL dizesini alır veya ayarlar.
UpdateCommandType	Özelliğindeki UpdateCommand metnin SQL deyimi mi yoksa saklı yordamın adı mı olduğunu belirten bir değer alır veya ayarlar.
UpdateParameters	özelliği tarafından UpdateCommand kullanılan parametreleri içeren parameters koleksiyonunu alır.

Yöntemler

CanExecute(String)	Belirtilen komutun yürütülip yürütülemeyeceğini belirler. (Devralındığı yer: DataSourceView)
Delete(IDictionary, IDictionary)	SQL dizesini DeleteCommand , koleksiyonda DeleteParameters belirtilen parametreleri ve belirtilen `keys` ve `oldValues` koleksiyonlardaki değerleri kullanarak bir silme işlemi gerçekleştirir.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Nesnenin temsil ettiği veri DataSourceView listesinde zaman uyumsuz silme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExecuteCommand(String, IDictionary, IDictionary)	Belirtilen komutu yürütür. (Devralındığı yer: DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Belirtilen komutu yürütür. (Devralındığı yer: DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	SQL dizesini DeleteCommand , koleksiyonda DeleteParameters belirtilen parametreleri ve belirtilen `keys` ve `oldValues` koleksiyonlardaki değerleri kullanarak bir silme işlemi gerçekleştirir.
ExecuteInsert(IDictionary)	SQL dizesiniInsertCommand, koleksiyonda belirtilen tüm parametreleri ve belirtilen `values` koleksiyondaki InsertParameters değerleri kullanarak bir ekleme işlemi gerçekleştirir.
ExecuteSelect(DataSourceSelectArguments)	SQL dizesini ve koleksiyondaki parametreleri kullanarak SelectCommand temel alınan veritabanından SelectParameters veri alır.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	SQL dizesini UpdateCommand , koleksiyondaki UpdateParameters tüm parametreleri ve belirtilen `keys`, `values`ve `oldValues` koleksiyonlarındaki değerleri kullanarak bir güncelleştirme işlemi gerçekleştirir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Insert(IDictionary)	SQL dizesiniInsertCommand, koleksiyonda belirtilen tüm parametreleri ve belirtilen `values` koleksiyondaki InsertParameters değerleri kullanarak bir ekleme işlemi gerçekleştirir.
Insert(IDictionary, DataSourceViewOperationCallback)	Nesnenin temsil ettiği veri DataSourceView listesinde zaman uyumsuz ekleme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
LoadViewState(Object)	Veri kaynağı görünümü için önceden kaydedilmiş görünüm durumunu geri yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDataSourceViewChanged(EventArgs)	Olayı tetikler DataSourceViewChanged . (Devralındığı yer: DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Denetim silme işlemini tamamladıktan sonra SqlDataSource olayı tetiklerDeleted.
OnDeleting(SqlDataSourceCommandEventArgs)	Deleting Denetim silme işlemini denemeden önce SqlDataSource olayı tetikler.
OnFiltering(SqlDataSourceFilteringEventArgs)	Denetim bir seçme işleminin SqlDataSource sonuçlarını filtrelemeden önce olayı tetiklerFiltering.
OnInserted(SqlDataSourceStatusEventArgs)	Denetim ekleme işlemini tamamladıktan sonra SqlDataSource olayı tetiklerInserted.
OnInserting(SqlDataSourceCommandEventArgs)	Inserting Denetim ekleme işlemini denemeden önce SqlDataSource olayı tetikler.
OnSelected(SqlDataSourceStatusEventArgs)	Denetim bir veri alma işlemini tamamladıktan sonra SqlDataSource olayı tetiklerSelected.
OnSelecting(SqlDataSourceSelectingEventArgs)	Selecting Denetim bir veri alma işlemi denemeden önce SqlDataSource olayı tetikler.
OnUpdated(SqlDataSourceStatusEventArgs)	Denetim bir güncelleştirme işlemini tamamladıktan sonra SqlDataSource olayı tetiklerUpdated.
OnUpdating(SqlDataSourceCommandEventArgs)	Updating Denetim bir güncelleştirme işlemi denemeden önce SqlDataSource olayı tetikler.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Bir ExecuteSelect(DataSourceSelectArguments) işlem için istenen özellikleri görünümün desteklediği ve yöntemi tarafından çağrılan özelliklerle RaiseUnsupportedCapabilitiesError(DataSourceView) karşılaştırır.
SaveViewState()	Sayfanın sunucuya geri gönderildiği zamandan bu yana denetimin görünüm durumundaki SqlDataSourceView değişiklikleri kaydeder.
Select(DataSourceSelectArguments)	SQL dizesini ve koleksiyondaki parametreleri kullanarak SelectCommand temel alınan veritabanından SelectParameters veri alır.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Temel alınan veri depolama alanından zaman uyumsuz olarak bir veri listesi alır. (Devralındığı yer: DataSourceView)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TrackViewState()	Değişikliklerin denetimin SqlDataSourceView nesnesinde StateBag depolanabilmesi ve aynı sayfaya yönelik istekler arasında kalıcı olması için nesnenin görünüm durumundaki değişiklikleri izlemesine neden olur.
Update(IDictionary, IDictionary, IDictionary)	SQL dizesini UpdateCommand , koleksiyondaki UpdateParameters tüm parametreleri ve belirtilen `keys`, `values`ve `oldValues` koleksiyonlarındaki değerleri kullanarak bir güncelleştirme işlemi gerçekleştirir.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Nesnenin temsil ettiği veri DataSourceView listesinde zaman uyumsuz bir güncelleştirme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)

Ekinlikler

DataSourceViewChanged	Veri kaynağı görünümü değiştiğinde gerçekleşir. (Devralındığı yer: DataSourceView)
Deleted	Silme işlemi tamamlandığında gerçekleşir.
Deleting	Silme işleminden önce gerçekleşir.
Filtering	Filtre işleminden önce gerçekleşir.
Inserted	Ekleme işlemi tamamlandığında gerçekleşir.
Inserting	Ekleme işleminden önce gerçekleşir.
Selected	Veri alma işlemi tamamlandığında gerçekleşir.
Selecting	Veri alma işleminden önce gerçekleşir.
Updated	Güncelleştirme işlemi tamamlandığında gerçekleşir.
Updating	Güncelleştirme işleminden önce gerçekleşir.

Belirtik Arabirim Kullanımları

IStateManager.IsTrackingViewState	Bu üyenin açıklaması için bkz IsTrackingViewState. .
IStateManager.LoadViewState(Object)	Bu üyenin açıklaması için bkz LoadViewState(Object). .
IStateManager.SaveViewState()	Bu üyenin açıklaması için bkz SaveViewState(). .
IStateManager.TrackViewState()	Bu üyenin açıklaması için bkz TrackViewState(). .

Şunlara uygulanır