OleDbDataAdapter Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-rc.1.24431.7

Kaynak:

OleDbDataAdapter.cs

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

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

type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    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 ö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. 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. .

Ayrıca bkz.

• DataAdapters ve DataReaders