OleDbDataAdapter Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.dll

Veri kaynağını doldurmak DataSet ve güncelleştirmek için kullanılan bir veri komutları kümesini ve veritabanı bağlantısını temsil eder.

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

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

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

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Devralma

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Uygulamalar

IDataAdapter IDbDataAdapter ICloneable

Örnekler

Aşağıdaki örnekteOleDbCommand, Access veri kaynağından kayıtları seçmek ve OleDbDataAdapteröğesini seçili satırlarla doldurmak OleDbConnection için , DataSet ve 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 SQL SELECT deyimi olan bir sorgu dizesi geçirilir.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Açıklamalar

, OleDbDataAdapter veri almak ve kaydetmek için bir DataSet ve veri kaynağı arasında bir köprü görevi görür. OleDbDataAdapter, veri kaynağındaki verileri içine Fillyüklemek için kullanarak DataSet ve geride Update yapılan değişiklikleri veri kaynağına göndermek için kullanarak DataSet bu köprüyü sağlar.

OleDbDataAdapter bir DataSetöğesini doldurduğunda, döndürülen veriler için henüz mevcut değilse uygun 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 OleDbDataAdapter kullanarak verilerle DataSetdoldurmadan önce birincil anahtar bilgileri de dahil olmak üzere şemasını FillSchemaoluşturabilirsiniz. Daha fazla bilgi için bkz. DataSet'e Mevcut Kısıtlamaları Ekleme.

MSDataShape sağlayıcısı da dahil olmak üzere bazı OLE DB sağlayıcılarının temel tablo veya birincil anahtar bilgilerini döndürmediğini unutmayın. Bu nedenle, OleDbDataAdapter özelliği oluşturulan PrimaryKeyherhangi bir üzerinde doğru ayarlayamazDataTable. Bu durumlarda, içindeki DataSettablolar için birincil anahtarları açıkça belirtmeniz gerekir.

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

örneğini OleDbDataAdapteroluşturduğunuzda, özellikler ilk değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya OleDbDataAdapter bakın.

Oluşturucular

Name	Description
OleDbDataAdapter()	OleDbDataAdapter sınıfının yeni bir örneğini başlatır.
OleDbDataAdapter(OleDbCommand)	özelliği olarak belirtilen OleDbDataAdapter sınıfın OleDbCommand yeni bir örneğini SelectCommand başlatır.
OleDbDataAdapter(String, OleDbConnection)	ile sınıfının yeni bir OleDbDataAdapterörneğini SelectCommand başlatır.
OleDbDataAdapter(String, String)	ile sınıfının yeni bir OleDbDataAdapterörneğini SelectCommand 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	AcceptChanges() işlemlerinden herhangi biri sırasında öğesine eklendikten DataRow sonra üzerinde çağrılıp çağrılmayacağını DataTable belirten bir değer alır veya ayarlar. (Devralındığı yer: DataAdapter)
AcceptChangesDuringUpdate	bir sırasında AcceptChanges()çağrılıp çağrılmayacağını Update(DataSet) 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 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 DataTableöğesini nasıl doldurduğunu DbDataReader belirleyen öğesini alır veya ayarlar. (Devralındığı yer: DataAdapter)
InsertCommand	Veri kaynağına yeni kayıtlar eklemek için kullanılan bir 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 bir 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	Toplu işlem desteğini etkinleştiren veya devre dışı bırakan bir değer 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 bir 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 DataSet adlarını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki DataTable satırları ekler veya yeniler. (Devralındığı yer: DbDataAdapter)
Fill(DataSet, Object, String)	belirtilen DataSet, ADO nesnesini ve kaynak tablo adını kullanarak bir ADO Recordset veya nesnedekilerle eşleşecek şekilde içindeki satırları Record ekler veya DataSet yeniler.
Fill(DataSet, String)	ve DataSet adlarını kullanarak DataSet veri kaynağındakilerle DataTable 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 DataTableDataTable ve IDbCommandkullanarak veri kaynağındakilerle eşleşecek şekilde içindeki CommandBehavior satırları ekler veya yeniler. (Devralındığı yer: DbDataAdapter)
Fill(DataTable, Object)	Belirtilen DataTable ve ADO nesnelerini kullanarak ADO Recordset veya nesnedekilerle eşleşecek şekilde içindeki satırları Record ekler veya DataTable yeniler.
Fill(DataTable)	Adı kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki 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 DataSet adlarını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde içinde belirtilen aralıktaki DataTable 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 DataTableöğesine bir DataSet ekler. (Devralındığı yer: DataAdapter)
FillSchema(DataSet, SchemaType, String)	Belirtilen öğesine bir DataTable ekler ve şemayı, belirtilen DataSet ve SchemaTypetemel alınarak veri kaynağındaki şemayla eşleşecek şekilde yapılandırılır.DataTable (Devralındığı yer: DbDataAdapter)
FillSchema(DataSet, SchemaType)	Belirtilen DataTable öğesine adlandırılmış bir DataSet "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 DataTableöğesine bir DataSet 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 Fill(DataSet)neden olurAcceptChangesDuringFill. (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 DataSet adla eklenen, güncelleştirilen veya silinen her satır DataTable 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ılır. Bu nedenle, olay gerçekleşir.
RowUpdating	Veri kaynağında bir komut yürütülmeden önce gerçekleşir Update(DataSet) . Güncelleştirme girişimi yapılır. Bu nedenle, olay gerçekleşir.

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)