OleDbDataAdapter Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v11.0.0-preview.2.26159.112

Kaynak:

OleDbDataAdapter.cs

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
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

Öznitelikler

RequiresDynamicCodeAttribute

Uygulamalar

IDataAdapter IDbDataAdapter ICloneable

Örnekler

Aşağıdaki örnekteOleDbCommand, Access veri kaynağından kayıtları seçmek ve OleDbConnectionöğesini seçili satırlarla doldurmak DataSet için , OleDbDataAdapter 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 DataSetyüklemek için kullanarak Fill ve geride DataSet yapılan değişiklikleri veri kaynağına göndermek için kullanarak Update 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 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.

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. Bu durumlarda, içindeki DataSettablolar için birincil anahtarları açıkça belirtmeniz gerekir.

ayrıcaOleDbDataAdapter, verilerin yüklenmesini SelectCommandve TableMappings güncelleştirilmesini kolaylaştırmak için , InsertCommandDeleteCommand, , UpdateCommand, 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 OleDbCommand sınıfın OleDbDataAdapter yeni bir örneğini SelectCommand başlatır.
OleDbDataAdapter(String, OleDbConnection)	ile sınıfının yeni bir SelectCommandörneğini OleDbDataAdapter başlatır.
OleDbDataAdapter(String, String)	ile sınıfının yeni bir SelectCommandörneğini OleDbDataAdapter başlatır.

Özellikler

Name	Description
DeleteCommand	Veri kümesinden kayıtları silmek için sql deyimini veya saklı yordamı alır veya ayarlar.
InsertCommand	Veri kaynağına yeni kayıtlar eklemek için kullanılan bir SQL deyimini veya saklı yordamı alır veya ayarlar.
SelectCommand	Veri kaynağındaki kayıtları seçmek için kullanılan bir SQL deyimini veya saklı yordamı alır veya ayarlar.
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
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ı DataSet ekler veya Record yeniler.
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.

Ekinlikler

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