OleDbDataAdapter Sınıf

Tanım

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

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

Örnekler

Aşağıdaki örnekte, Access veri kaynağından kayıtları seçmek ve OleDbConnectionöğesini seçili satırlarla doldurmak DataSet için , OleDbDataAdapter ve kullanılırOleDbCommand. Doldurulan DataSet daha sonra döndürülür. Bunu başarmak için yöntemine başlatıldı 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 ve veri kaynağı arasında bir DataSet köprü görevi görür. OleDbDataAdapter, veri kaynağındaki verileri içine DataSetyüklemek için kullanarak Fill ve gerisinde DataSet yapılan değişiklikleri veri kaynağına göndermek için komutunu kullanarak Update bu köprüyü sağlar.

OleDbDataAdapter bir DataSetöğesini doldurduğunda, döndürülen veriler için henüz yoksa 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 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.

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 DataTableherhangi bir üzerinde doğru ayarlayamazPrimaryKey. Böyle durumlarda içindeki tablolar DataSetiçin birincil anahtarları açıkça belirtmeniz gerekir.

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

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

Oluşturucular

OleDbDataAdapter()

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

OleDbDataAdapter(OleDbCommand)

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

OleDbDataAdapter(String, OleDbConnection)

ile SelectCommandsınıfının yeni bir örneğini OleDbDataAdapter başlatır.

OleDbDataAdapter(String, String)

ile SelectCommandsınıfının yeni bir örneğini OleDbDataAdapter 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 bir SQL deyimi 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 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 DataTablekoleksiyonu alır.

(Devralındığı yer: DataAdapter)
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 bir 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, Object, String)

belirtilen DataSet, ADO nesnesi ve kaynak tablo adını kullanarak ADO Recordset veya nesnedekilerle eşleşecek şekilde içindeki satırları DataSet ekler veya Record yeniler.

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, Object)

Belirtilen DataTable ve ADO nesnelerini kullanarak ADO Recordset veya nesnedekilerle eşleşecek şekilde içindeki satırları DataTable ekler veya Record yeniler.

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ılır. Bu nedenle, olay gerçekleşir.

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ılır. Bu nedenle, olay gerçekleşir.

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.