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, öncelikli olarak 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şkili olduğu denetimin SqlDataSource özelliklerini tanımlar ve veri kaynağı denetimi için temel veri işlevselliğini uygular. SqlDataSourceView sınıfı, denetim için SqlDataSource görünüm durumunda tutulan , Update, Insertve Delete işlemleri, sıralama, filtreleme ve yönetme ayarları dahil olmak üzere Selectveri işlevselliğini uygular.

Nesne, denetim tarafından SqlDataSource sayfa geliştiricilerine doğrudan gösterilmese SqlDataSourceView de, özelliklerinin çoğu vardır. Bir veri kaynağı görünümünün gerçekleştirdiği en temel işlem, veri öğelerinin koleksiyonunu alan yöntemini kullanarak Select temel alınan veritabanından veri almaktır IEnumerable . 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:

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

nesnesi, SqlDataSourceView SQL komutlarını kullanarak ilişkisel veritabanındaki verilerin güncelleştirilmesini destekler. DAHA fazla esneklik ve güvenlik için SQL komutları parametreleştirilebilir. ve DetailsViewgibi GridView veriye bağlı denetimler, diğer denetimler tarafından kullanılarak güncelleştirmeleri otomatik SqlDataSourceViewolarak gerçekleştirecek şekilde yapılandırılabilir. 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:

özelliği UpdateCommand
özelliği UpdateParameters
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, eklemeleri kullanarak otomatik SqlDataSourceViewolarak gerçekleştirmek üzere yapılandırılabilir, ancak diğer denetimler bunu yapamaz. 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:

özelliği InsertCommand
özelliği InsertParameters
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:

özelliği DeleteCommand
özelliği DeleteParameters
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, web forms sayfasındaki denetimlerde görüntülenen değerler gibi değişebilen değerlere 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.

Denetimle birlikte SqlDataSource aldığınız verileri sıralamak için ORDER BY yan tümcesi ekleyebilirsiniz. Bu, veritabanının verileri aldığınızda veya verileri alındıktan sonra bellekte sıralayarak sizin için sıralamasını gerçekleştirmesine neden olur. 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, saklı yordam çağrısının SortParameterName sonuçlarını sıralamak için özel olarak kullanılan bir parametre belirtmek için özelliğini de kullanabilirsiniz.

Birden fazla kullanıcı veritabanını eşzamanlı olarak 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. İşlev ö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 ve , 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)

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

Özellikler

CancelSelectOnNullParameter	Koleksiyonunda SelectParameters yer alan 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	öğesinin 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 herhangi bir parametre yer tutucusu FilterExpression ile ilişkili 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üne eklemek 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, DataSourceViewOperationCallback)	Nesnenin temsil ettiğini veri DataSourceView listesinde zaman uyumsuz silme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
Delete(IDictionary, IDictionary)	SQL dizesini DeleteCommand , koleksiyonda DeleteParameters belirtilen tüm parametreleri ve belirtilen `keys` ve `oldValues` koleksiyonlardaki değerleri kullanarak silme işlemi gerçekleştirir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Belirtilen komutu yürütür. (Devralındığı yer: DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Belirtilen komutu yürütür. (Devralındığı yer: DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	SQL dizesini DeleteCommand , koleksiyonda DeleteParameters belirtilen tüm parametreleri ve belirtilen `keys` ve `oldValues` koleksiyonlardaki değerleri kullanarak 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 SelectCommand parametreleri kullanarak 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, DataSourceViewOperationCallback)	Nesnenin temsil olduğu veri DataSourceView listesinde zaman uyumsuz ekleme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
Insert(IDictionary)	SQL dizesiniInsertCommand, koleksiyonda belirtilen tüm parametreleri ve belirtilen `values` koleksiyondaki InsertParameters değerleri kullanarak bir ekleme işlemi gerçekleştirir.
LoadViewState(Object)	Veri kaynağı görünümü için daha önce 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, DataSourceViewSelectCallback)	Temel alınan veri depolama alanından zaman uyumsuz olarak bir veri listesi alır. (Devralındığı yer: DataSourceView)
Select(DataSourceSelectArguments)	SQL dizesini ve koleksiyondaki SelectCommand parametreleri kullanarak temel alınan veritabanından SelectParameters veri alır.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TrackViewState()	Nesnenin SqlDataSourceView görünüm durumundaki değişiklikleri izlemesine neden olur, böylece değişiklikler denetimin StateBag nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale getirilir.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Nesnenin temsil olduğu veri DataSourceView listesinde zaman uyumsuz bir güncelleştirme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
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.

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	Bir 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

Aracılığıyla paylaş