SqlDataAdapter Sınıf

Tanım

SQL Server veritabanını doldurmak ve güncelleştirmek için kullanılan bir dizi veri komutunu DataSet ve veritabanı bağlantısını temsil eder. Bu sınıf devralınamaz.

public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter
type SqlDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
type SqlDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Devralma
Uygulamalar

Örnekler

Aşağıdaki örnekte, veritabanından SqlCommandkayıtları seçmek ve SqlConnection bir öğesini seçili satırlarla doldurmak DataSet için , SqlDataAdapterve kullanılır. Doldurulan DataSet daha sonra döndürülür. Bunu başarmak için yöntemine başlatıldıDataSet, bir bağlantı dizesi ve Transact-SQL SELECT deyimi olan bir sorgu dizesi geçirilir.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}
Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Açıklamalar

SqlDataAdapter, verileri almak ve kaydetmek için ve SQL Server arasında bir DataSet köprü görevi görür. , SqlDataAdapter içindeki verileri veri kaynağındaki DataSet verilerle eşleşecek şekilde değiştiren ve Updateveri kaynağındaki verileri içindeki verilerle DataSeteşleşecek şekilde değiştiren ve veri kaynağında uygun Transact-SQL deyimlerini kullanarak bu köprüyü eşleyerek Fillsağlar. Güncelleştirme, satır temelinde gerçekleştirilir. Eklenen, değiştirilen ve silinen her satır için yöntemi, Update üzerinde gerçekleştirilen değişikliğin türünü (Insert, Updateveya Delete) belirler. Değişikliğin türüne bağlı olarak, Insertdeğiştirilen satırı veri kaynağına yaymak için , Updateveya Delete komut şablonu yürütülür. SqlDataAdapter bir DataSetöğesini doldurduğunda, döndürülen veriler henüz yoksa, döndürülen veriler için gerekli tabloları ve sütunları oluşturur. Ancak, özelliği olarak ayarlanmadığı sürece birincil anahtar bilgileri örtük olarak oluşturulan şemaya MissingSchemaActionAddWithKeydahil değildir. ayrıca SqlDataAdapter kullanarak verileriyle FillSchemadoldurmadan önce birincil anahtar bilgileri de dahil olmak üzere şemasını DataSetoluşturabilirsiniz. Daha fazla bilgi için bkz. DataSet'e Varolan Kısıtlamaları Ekleme.

SqlDataAdapterbir SQL Server veritabanına bağlanırken performansı artırmak için ve SqlCommand ile SqlConnection birlikte kullanılır.

Not

kullanarak verileri DataAdapterdüzenlemek veya silmek için SQL Server saklı yordamlar kullanıyorsanız saklı yordam tanımında SET NOCOUNT ON kullanmadığınızdan emin olun. Bu, etkilenen satır sayısının sıfır olmasına neden olur ve bu DataAdapter da eşzamanlılık çakışması olarak yorumlar. Bu olayda bir DBConcurrencyException oluşturulur.

ayrıcaSqlDataAdapter, verilerin yüklenmesini SelectCommandve TableMappings güncelleştirilmesini kolaylaştırmak için , InsertCommandDeleteCommand, , UpdateCommandve özelliklerini içerir.

Örneği SqlDataAdapter oluşturulduğunda, okuma/yazma özellikleri başlangıç değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya SqlDataAdapter bakın.

InsertCommand, DeleteCommandve UpdateCommand parametreleri mekanizması aracılığıyla değiştirilen her satırdaki tek tek değerlerle otomatik olarak doldurulan genel şablonlardır.

üzerindeki Updateveri kaynağına yaydığınız her sütun için , UpdateCommandveya DeleteCommandöğesine bir parametre eklenmelidirInsertCommand. SourceColumn nesnesinin DbParameter özelliği sütunun adına ayarlanmalıdır. Bu ayar parametrenin değerinin el ile ayarlanmadığını ancak o anda işlenen satırdaki belirli bir sütundan alındığını gösterir.

Not

InvalidOperationException yöntemi çağrılırsa Fill ve tablo istemci bilgisayarda bulunmayan kullanıcı tanımlı bir tür içeriyorsa oluşur. Daha fazla bilgi için bkz. CLR User-Defined Türleri.

Oluşturucular

SqlDataAdapter()

SqlDataAdapter sınıfının yeni bir örneğini başlatır.

SqlDataAdapter(SqlCommand)

özelliği olarak belirtilen SqlCommand sınıfın SqlDataAdapter yeni bir örneğini SelectCommand başlatır.

SqlDataAdapter(String, SqlConnection)

ve nesnesiyle SelectCommand sınıfının yeni bir SqlConnection örneğini SqlDataAdapter başlatır.

SqlDataAdapter(String, String)

ve bağlantı dizesi ile SelectCommand sınıfının yeni bir örneğini SqlDataAdapter başlatır.

Alanlar

DefaultSourceTableName

Nesne tarafından DataAdapter tablo eşlemeleri için kullanılan varsayılan ad.

(Devralındığı yer: DbDataAdapter)

Özellikler

AcceptChangesDuringFill

Fill işlemlerinden herhangi biri sırasında öğesine eklendikten DataTable sonra üzerinde çağrılıp çağrılmayacağını AcceptChanges() belirten bir DataRow değeri alır veya ayarlar.

(Devralındığı yer: DataAdapter)
AcceptChangesDuringUpdate

bir Update(DataSet)sırasında çağrılıp çağrılmayacağını AcceptChanges() alır veya ayarlar.

(Devralındığı yer: DataAdapter)
CanRaiseEvents

Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır.

(Devralındığı yer: Component)
Container

öğesini IContainer içeren öğesini Componentalır.

(Devralındığı yer: Component)
ContinueUpdateOnError

Satır güncelleştirmesi sırasında hatayla karşılaşıldığında özel durum oluşturulup oluşturulmayacağını belirten bir değer alır veya ayarlar.

(Devralındığı yer: DataAdapter)
DeleteCommand

Veri kümesinden kayıtları silmek için transact-SQL deyimini veya saklı yordamı alır veya ayarlar.

DesignMode

öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır.

(Devralındığı yer: Component)
Events

Bu Componentöğesine eklenen olay işleyicilerinin listesini alır.

(Devralındığı yer: Component)
FillCommandBehavior

Veri bağdaştırıcısını doldurmak için kullanılan komutun davranışını alır veya ayarlar.

(Devralındığı yer: DbDataAdapter)
FillLoadOption

Bağdaştırıcının LoadOption 'den DbDataReaderdosyasını nasıl doldurduğunu belirleyen öğesini DataTable alır veya ayarlar.

(Devralındığı yer: DataAdapter)
InsertCommand

Veri kaynağına yeni kayıtlar eklemek için transact-SQL deyimini veya saklı yordamını alır veya ayarlar.

MissingMappingAction

Gelen verilerin eşleşen bir tablosu veya sütunu olmadığında yapılacak eylemi belirler.

(Devralındığı yer: DataAdapter)
MissingSchemaAction

Mevcut DataSet şema gelen verilerle eşleşmediğinde yapılacak eylemi belirler.

(Devralındığı yer: DataAdapter)
ReturnProviderSpecificTypes

Yöntemin sağlayıcıya Fill özgü değerler mi yoksa ortak CLS uyumlu değerler mi döndürmesi gerektiğini alır veya ayarlar.

(Devralındığı yer: DataAdapter)
SelectCommand

Veri kaynağındaki kayıtları seçmek için kullanılan transact-SQL deyimini veya saklı yordamı alır veya ayarlar.

Site

öğesini alır veya ayarlar ISiteComponent.

(Devralındığı yer: Component)
TableMappings

Kaynak tablo ile arasında birincil eşleme sağlayan bir DataTablekoleksiyonu alır.

(Devralındığı yer: DataAdapter)
UpdateBatchSize

Sunucuya yapılan her gidiş dönüşte işlenen satır sayısını alır veya ayarlar.

UpdateBatchSize

Toplu işlem desteğini etkinleştiren veya devre dışı bırakan bir değeri alır veya ayarlar ve toplu işlemde yürütülebilecek komut sayısını belirtir.

(Devralındığı yer: DbDataAdapter)
UpdateCommand

Veri kaynağındaki kayıtları güncelleştirmek için kullanılan transact-SQL deyimini veya saklı yordamı alır veya ayarlar.

Yöntemler

AddToBatch(IDbCommand)

Geçerli toplu iş için bir IDbCommand ekler.

(Devralındığı yer: DbDataAdapter)
ClearBatch()

Toplu işlemden tüm IDbCommand nesneleri kaldırır.

(Devralındığı yer: DbDataAdapter)
CloneInternals()
Geçersiz.
Geçersiz.
Geçersiz.
Geçersiz.

Bu örneğinin DataAdapterbir kopyasını oluşturur.

(Devralındığı yer: DataAdapter)
CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatedEventArgs sınıfının yeni bir örneğini başlatır.

(Devralındığı yer: DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatingEventArgs sınıfının yeni bir örneğini başlatır.

(Devralındığı yer: DbDataAdapter)
CreateTableMappings()

Yeni bir DataTableMappingCollection oluşturur.

(Devralındığı yer: DataAdapter)
Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

DbDataAdapter tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

(Devralındığı yer: DbDataAdapter)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
ExecuteBatch()

Geçerli toplu işlemi yürütür.

(Devralındığı yer: DbDataAdapter)
Fill(DataSet)

içindeki DataSetsatırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataSet, Int32, Int32, String)

ve DataTable adlarını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki DataSet satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

ve kaynak tablo adlarını, komut dizesini DataSet ve komut davranışını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataSet, String)

ve DataTable adlarını kullanarak DataSet veri kaynağındakilerle DataSet eşleşecek şekilde içindeki satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)

, DataTableve IDataReader adlarını kullanarak DataSetveri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki DataSet satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataTable)

veri kaynağındakilerle eşleşecek şekilde belirtilen aralıktaki DataSet satırları adı kullanarak DataTable ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataTable, IDataReader)

Belirtilen DataTable ve IDataReader adlarını kullanarak veri kaynağındakilerle eşleşecek şekilde içindeki DataTable satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)

Belirtilen DataTableIDbCommand ve CommandBehaviorkullanarak veri kaynağındakilerle eşleşecek şekilde içindeki DataTable satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)

Veri kaynağındakilerle eşleşecek şekilde nesne koleksiyonunda DataTable belirtilen aralıktaki satırları ekler veya yeniler.

(Devralındığı yer: DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

ve DataTable adlarını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki DataSet satırları ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
Fill(Int32, Int32, DataTable[])

Bir veya daha fazla DataTable nesnedeki satırları, belirtilen kayıtta başlayan ve belirtilen kayıt sayısı üst sınırına kadar alan veri kaynağındakilerle eşleşecek şekilde ekler veya yeniler.

(Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType)

Belirtilen DataSet öğesine adlandırılmış bir DataTable "Tablo" ekler ve şemayı belirtilen SchemaTypetemelinde veri kaynağındakiyle eşleşecek şekilde yapılandırılır.

(Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Belirtilen DataSet öğesine bir DataTable ekler ve şemayı, belirtilen SchemaTypetemelinde veri kaynağındakiyle eşleşecek şekilde yapılandırılır.

(Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType, String)

Belirtilen öğesine bir DataTable ekler ve şemayı, belirtilen SchemaType ve DataTabletemel alınarak veri kaynağındaki şemayla eşleşecek şekilde yapılandırılır.DataSet

(Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)

Belirtilen DataSetöğesine bir DataTable ekler.

(Devralındığı yer: DataAdapter)
FillSchema(DataTable, SchemaType)

Belirtilen öğesinin şemasını belirtilen DataTableSchemaTypeöğesine göre yapılandırıyor.

(Devralındığı yer: DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)

Belirtilen DataSetöğesine bir DataTable ekler.

(Devralındığı yer: DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Belirtilen DataTable öğesinin şemasını belirtilen SchemaType, komut dizesine ve CommandBehavior değerlere göre yapılandırılır.

(Devralındığı yer: DbDataAdapter)
GetBatchedParameter(Int32, Int32)

Geçerli toplu iş içindeki komutlardan birinden bir IDataParameter döndürür.

(Devralındığı yer: DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)

Daha büyük bir toplu güncelleştirme içindeki tek bir güncelleştirme girişimi hakkındaki bilgileri döndürür.

(Devralındığı yer: DbDataAdapter)
GetFillParameters()

SQL SELECT deyimini yürütürken kullanıcı tarafından ayarlanan parametreleri alır.

(Devralındığı yer: DbDataAdapter)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetService(Type)

veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
HasTableMappings()

oluşturulup DataTableMappingCollection oluşturulmadığını gösterir.

(Devralındığı yer: DataAdapter)
InitializeBatching()

için DbDataAdaptertoplu işlemi başlatır.

(Devralındığı yer: DbDataAdapter)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Olayı tetikler FillError .

(Devralındığı yer: DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

Bir .NET veri sağlayıcısının olayını tetikler RowUpdated .

(Devralındığı yer: DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)

Bir .NET veri sağlayıcısının olayını tetikler RowUpdating .

(Devralındığı yer: DbDataAdapter)
ResetFillLoadOption()

Varsayılan durumuna sıfırlanır FillLoadOption ve yerine getirilmesine AcceptChangesDuringFillneden olurFill(DataSet).

(Devralındığı yer: DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Özelliğin AcceptChangesDuringFill kalıcı olup olmayacağını belirler.

(Devralındığı yer: DataAdapter)
ShouldSerializeFillLoadOption()

Özelliğin FillLoadOption kalıcı olup olmayacağını belirler.

(Devralındığı yer: DataAdapter)
ShouldSerializeTableMappings()

Bir veya daha fazla DataTableMapping nesnenin var olup olmadığını ve kalıcı olması gerektiğini belirler.

(Devralındığı yer: DataAdapter)
TerminateBatching()

için toplu işlemi sonlandırır DbDataAdapter.

(Devralındığı yer: DbDataAdapter)
ToString()

Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır.

(Devralındığı yer: Component)
Update(DataRow[])

veritabanında belirtilen dizide DataSeteklenen, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini yürüterek veritabanındaki değerleri Güncelleştirmeler.

(Devralındığı yer: DbDataAdapter)
Update(DataRow[], DataTableMapping)

Belirtilen nesne dizisindeki DataRow eklenen, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini yürüterek veritabanındaki değerleri Güncelleştirmeler.

(Devralındığı yer: DbDataAdapter)
Update(DataSet)

Belirtilen DataSetiçindeki eklenen, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini yürüterek veritabanındaki değerleri Güncelleştirmeler.

(Devralındığı yer: DbDataAdapter)
Update(DataSet, String)

veritabanında DataTable belirtilen adla eklenen, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini yürüterek veritabanındaki DataSet değerleri Güncelleştirmeler.

(Devralındığı yer: DbDataAdapter)
Update(DataTable)

Belirtilen DataTableiçindeki eklenen, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini yürüterek veritabanındaki değerleri Güncelleştirmeler.

(Devralındığı yer: DbDataAdapter)

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir.

(Devralındığı yer: Component)
FillError

Doldurma işlemi sırasında bir hata oluştuğunda döndürülür.

(Devralındığı yer: DbDataAdapter)
RowUpdated

Veri kaynağında bir komut yürütüldükten sonra gerçekleşir Update(DataSet) . Güncelleştirme girişimi yapıldığından olay tetikleniyor.

RowUpdating

Veri kaynağında bir komut yürütülmeden önce sırasında Update(DataSet) gerçekleşir. Güncelleştirme girişimi yapıldığından olay tetikleniyor.

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Bu üyenin açıklaması için bkz Clone(). .

IDataAdapter.TableMappings

Kaynak tablonun bir veri kümesi tablosuna nasıl eşlendiğini gösteren bir koleksiyon alır.

(Devralındığı yer: DataAdapter)
IDbDataAdapter.DeleteCommand

Bu üyenin açıklaması için bkz DeleteCommand. .

IDbDataAdapter.InsertCommand

Bu üyenin açıklaması için bkz InsertCommand. .

IDbDataAdapter.SelectCommand

Bu üyenin açıklaması için bkz SelectCommand. .

IDbDataAdapter.UpdateCommand

Bu üyenin açıklaması için bkz UpdateCommand. .

Şunlara uygulanır

Ayrıca bkz.