Aracılığıyla paylaş


SqlDataSourceView Sınıf

Tanım

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
SqlDataSourceView
Türetilmiş
Uygulamalar

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:

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:

, 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:

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:

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 SortExpressionDataSourceSelectArguments ö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 IsTrackingViewStateLoadViewStateuygulamaları, 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 nullveri 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, valuesve 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, valuesve 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

Ayrıca bkz.