SqlDataAdapter Sınıf

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

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

public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type SqlDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Devralma

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Uygulamalar

IDataAdapter IDbDataAdapter ICloneable

Örnekler

Aşağıdaki örnekte, veritabanından SqlCommandkayıtları seçmek ve SqlConnection öğesini seçili satırlarla doldurmak DataSet için , SqlDataAdapterve kullanılır. Ardından doldurulan DataSet döndürülür. Bunu başarmak için yöntemine bir başlatılan DataSet, 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

, SqlDataAdapterverileri almak ve kaydetmek için bir DataSet ile SQL Server arasında bir 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, veri kaynağında uygun Transact-SQL deyimlerini kullanarak içindeki verilerle DataSeteşleşecek şekilde değiştiren öğesini eşleyerek Fillbu köprüyü sağ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 , InsertUpdateveya Delete komut şablonu, değiştirilen satırı veri kaynağına yaymak için yürütülür. SqlDataAdapter bir DataSetöğesini doldurduğunda, döndürülen veriler için gerekli tabloları ve sütunları oluşturur( henüz yoksa). Ancak, özelliği olarak ayarlanmadığı sürece birincil anahtar bilgileri örtük olarak oluşturulan şemaya MissingSchemaActionAddWithKeydahil değildir. ayrıca SqlDataAdapter kullanarak verilerle FillSchemadoldurmadan önce birincil anahtar bilgileri de dahil olmak üzere şemasını DataSetoluşturabilirsiniz. Daha fazla bilgi için bkz. DataSet'e Mevcut Kısıtlamaları Ekleme.

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

Uyarı

SQL Server saklı yordamlarını kullanarak DataAdapter ile verileri düzenlemek veya silmek istiyorsanız, saklı yordam tanımında SET NOCOUNT ON ifadesini kullanmadığınızdan emin olun. Bu, etkilenen satır sayısının sıfır olarak geri dönmesine neden olur, ve DataAdapter bunu bir eşzamanlılık çakışması olarak yorumlar. Bu olayda bir DBConcurrencyException fırlatılır.

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

Örneği SqlDataAdapter oluşturulduğunda, okuma/yazma özellikleri ilk değerlere 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.

Uyarı

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 Kullanıcı Tanımlı Türler.

Oluşturucular

Name	Description
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ı dizesiyle SelectCommand sınıfının yeni bir örneğini SqlDataAdapter başlatır.

Alanlar

Name	Description
DefaultSourceTableName	Nesne tarafından DataAdapter tablo eşlemeleri için kullanılan varsayılan ad. (Devralındığı yer: DbDataAdapter)

Özellikler

Name	Description
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ğer alır veya ayarlar. (Devralındığı yer: DataAdapter)
AcceptChangesDuringUpdate	bir sırasında Update(DataSet)ç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ümesindeki kayıtları silmek için bir 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 'LoadOptionden DbDataReaderöğesini nasıl doldurduğunu DataTable belirleyen öğesini alır veya ayarlar. (Devralındığı yer: DataAdapter)
InsertCommand	Veri kaynağına yeni kayıtlar eklemek için Transact-SQL deyimini veya saklı yordamı 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 DataTablekoleksiyon 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.
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

Name	Description
AddToBatch(IDbCommand)	Geçerli toplu işe 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. 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 DataTableMappingCollectionbir oluşturur. (Devralındığı yer: DataAdapter)
Dispose()	tarafından Componentkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından DbDataAdapter kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları 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, Int32, Int32, String, IDbCommand, CommandBehavior)	ve kaynak tablo adlarını, komut dizesini DataSet ve komut davranışını kullanarak veri kaynağındakilerle eşleşecek şekilde içindeki belirtilen aralıktaki DataSet satı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, 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)	içindeki DataSetsatı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)	Adı kullanarak DataTable veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki DataSet 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 en fazla kayıt sayısına kadar alan veri kaynağındakilerle eşleşecek şekilde ekler veya yeniler. (Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Belirtilen öğesine bir DataTable ekler ve şemayı, belirtilen DataSetSchemaTypetemelinde veri kaynağındaki şemayla eşleşecek şekilde yapılandırılır. (Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Belirtilen DataSetöğesine bir DataTable ekler. (Devralındığı yer: DataAdapter)
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)	Belirtilen DataSet öğesine adlandırılmış bir DataTable "Tablo" ekler ve şemayı belirtilen SchemaTypetemelinde veri kaynağındakiyle eşleşecek şekilde yapılandırır. (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)
FillSchema(DataTable, SchemaType)	Belirtilen öğesinin şemasını belirtilen DataTableSchemaTypeöğesine göre yapılandırıyor. (Devralındığı yer: DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Geçerli toplu işlemdeki 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 deyimi yürütülü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()	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 Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type 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()	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 Objectbasit 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)
OnRowUpdated(RowUpdatedEventArgs)	.NET veri sağlayıcısının olayını tetikler RowUpdated . (Devralındığı yer: DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	.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ı Stringiçeren bir Component döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)
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ştirir. (Devralındığı yer: DbDataAdapter)
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ştirir. (Devralındığı yer: DbDataAdapter)
Update(DataSet, String)	Veritabanındaki değerleri, belirtilen DataTable adla eklenen, güncelleştirilen veya silinen her satır DataSet için ilgili INSERT, UPDATE veya DELETE deyimlerini yürüterek güncelleştirir. (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ştirir. (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ştirir. (Devralındığı yer: DbDataAdapter)

Ekinlikler

Name	Description
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrıyla atıldığında gerçekleşir. (Devralındığı yer: Component)
RowUpdated	Update(DataSet) Veri kaynağında bir komut yürütüldükten sonra gerçekleşir. Güncelleştirme girişimi yapıldığından olay tetikleniyor.
RowUpdating	Veri kaynağında bir komut yürütülmeden önce gerçekleşir Update(DataSet) . Güncelleştirme girişimi yapıldığından olay tetikleniyor.

Belirtik Arabirim Kullanımları

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

Ayrıca bkz.

• Veri Adaptörleri (DataAdapters) ve Veri Okuyucular (DataReaders)
• Verileri Düzenleme (ADO.NET)
• ADO.NET’e Genel Bakış