SqlDataSourceView Sınıf

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

SqlDataSourceView Nesne, denetim tarafından SqlDataSource doğrudan sayfa geliştiricilerine açık olmasa da, ö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:

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. Sql komutları daha fazla esneklik ve güvenlik için parametreleştirilebilir. ve DetailsViewgibi GridView veriye bağlı denetimler, güncelleştirmeleri kullanarak otomatik SqlDataSourceViewolarak 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, öğesini kullanarak SqlDataSourceVieweklemeleri otomatik olarak gerçekleştirecek şekilde 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:

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, öğesini kullanarak SqlDataSourceViewsilme işlemlerini otomatik olarak gerçekleştirecek şekilde yapılandırılabilir, ancak diğer denetimler bunu yapamaz. 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, 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.

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

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

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

Oluşturucular

Name	Description
SqlDataSourceView(SqlDataSource, String, HttpContext)	Belirtilen SqlDataSource denetimi geçerli görünümün SqlDataSourceView sahibi olarak ayarlayarak sınıfın yeni bir örneğini başlatır.

Özellikler

Name	Description
CancelSelectOnNullParameter	Koleksiyonda 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 veriler üzerinde 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	İşlem sırasında temel alınan veritabanındaki bir satırdaki veriler değiştiğinde denetimin güncelleştirmeleri nasıl SqlDataSource gerçekleştirdiğini ve silindiğini gösteren değeri alır veya ayarlar.
DeleteCommand	Temel alınan veritabanındaki 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 FilterExpression tüm parametre yer tutucularıyla ilişkili bir parametre koleksiyonu 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 değişiklikleri görünüm durumuna 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 oluşturmak 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 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

Name	Description
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ği veri DataSourceView listesinde zaman uyumsuz silme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
Delete(IDictionary, IDictionary)	SQL dizesiniDeleteCommand, koleksiyonda belirtilen parametreleri ve belirtilen `keys` ve `oldValues` koleksiyonlardaki DeleteParameters 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 dizesiniDeleteCommand, koleksiyonda belirtilen parametreleri ve belirtilen `keys` ve `oldValues` koleksiyonlardaki DeleteParameters değerleri kullanarak silme işlemi gerçekleştirir.
ExecuteInsert(IDictionary)	SQL dizesiniInsertCommand, koleksiyonda belirtilen 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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Nesnenin temsil ettiği veri DataSourceView listesinde zaman uyumsuz ekleme işlemi gerçekleştirir. (Devralındığı yer: DataSourceView)
Insert(IDictionary)	SQL dizesiniInsertCommand, koleksiyonda belirtilen 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 Objectbasit 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, 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 parametreleri kullanarak SelectCommand temel alınan veritabanından SelectParameters veri alır.
ToString()	Geçerli nesneyi temsil eden bir dize 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ı olabilmesi için nesnenin görünüm durumundaki değişiklikleri izlemesine neden olur.
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)
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

Name	Description
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	Bir güncelleştirme işlemi tamamlandığında gerçekleşir.
Updating	Güncelleştirme işleminden önce gerçekleşir.

Belirtik Arabirim Kullanımları

Name	Description
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

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?