OleDbCommandBuilder 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:

OleDbCommandBuilder.cs

ile ilişkili veritabanıyla yapılan değişiklikleri mutabık hale getirmek için DataSet kullanılan tek tablolu komutları otomatik olarak oluşturur. Bu sınıf devralınamaz.

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Devralma

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

Örnekler

Aşağıdaki örnekte, veri kaynağından OleDbCommandsatır seçmek için ile birlikte OleDbDataAdapter ve OleDbConnectionkullanılır. Örnek, başlatılan DataSetbir , bağlantı dizesi, SQL SELECT deyimi olan bir sorgu dizesi ve veri kaynağı tablosunun adı olan bir dize geçirilir. Örnek daha sonra bir OleDbCommandBuilderoluşturur.

public static DataSet UpdateRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        cb.GetDeleteCommand();
        //Without the OleDbCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        connection.Close();
    }
    return dataSet;
}

Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        builder.GetUpdateCommand()

        ' Without the OleDbCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

Açıklamalar

, OleDbDataAdapter ile ilişkili veri kaynağında yapılan değişiklikleri mutabık hale getirmek için DataSet gereken SQL deyimlerini otomatik olarak oluşturmaz. Ancak, özelliğini OleDbDataAdapterayarlarsanız SelectCommand tek tablolu güncelleştirmeler için sql deyimlerini otomatik olarak oluşturmak üzere bir OleDbCommandBuilder nesne oluşturabilirsiniz. Ardından, ayarlamadığınız tüm ek SQL deyimleri tarafından OleDbCommandBuilderoluşturulur.

özelliği OleDbCommandBuilder her ayarlandığında DataAdapter olaylar için RowUpdating kendisini dinleyici olarak kaydeder. Bir kerede yalnızca bir OleDbDataAdapter nesneyi veya OleDbCommandBuilder nesneyi birbiriyle ilişkilendirebilirsiniz.

INSERT, UPDATE veya DELETE deyimleri oluşturmak için, OleDbCommandBuilder gerekli bir meta veri kümesini otomatik olarak almak için özelliğini kullanır SelectCommand . Meta veriler alındıktan sonra değerini değiştirirseniz SelectCommand , örneğin ilk güncelleştirmeden sonra meta verileri güncelleştirmek için yöntemini çağırmanız RefreshSchema gerekir.

, OleDbCommandBuilder tarafından başvuruda bulunan SelectCommandConnection, CommandTimeoutve Transaction özelliklerini de kullanır. Kullanıcı, bu özelliklerden biri veya daha fazlası değiştirilirse veya kendisi değiştirilirse SelectCommand çağırmalıdırRefreshSchema. InsertCommandAksi takdirde , UpdateCommandve DeleteCommand özellikleri önceki değerlerini korur.

çağrısı Disposeyaparsanız , OleDbCommandBuilder ile ilişkilendirilmez OleDbDataAdapterve oluşturulan komutlar artık kullanılmaz.

Oluşturucular

Name	Description
OleDbCommandBuilder()	OleDbCommandBuilder sınıfının yeni bir örneğini başlatır.
OleDbCommandBuilder(OleDbDataAdapter)	sınıfın OleDbCommandBuilder yeni bir örneğini ilişkili OleDbDataAdapter nesneyle başlatır.

Özellikler

Name	Description
DataAdapter	SQL deyimlerinin otomatik olarak oluşturulduğu nesneyi OleDbDataAdapter alır veya ayarlar.

Yöntemler

Name	Description
DeriveParameters(OleDbCommand)	içinde OleDbCommand belirtilen saklı yordamdan parametre bilgilerini alır ve belirtilen OleDbCommand nesnenin koleksiyonunu doldururParameters.
GetDeleteCommand()	Veri kaynağında silme işlemleri gerçekleştirmek için gereken otomatik olarak oluşturulan OleDbCommand nesneyi alır.
GetDeleteCommand(Boolean)	Veri kaynağında silme işlemleri gerçekleştirmek için gereken otomatik olarak oluşturulan OleDbCommand nesneyi alır.
GetInsertCommand()	Veri kaynağında eklemeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OleDbCommand nesneyi alır.
GetInsertCommand(Boolean)	Veri kaynağında eklemeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OleDbCommand nesneyi alır.
GetUpdateCommand()	Veri kaynağında güncelleştirmeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OleDbCommand nesneyi alır.
GetUpdateCommand(Boolean)	İsteğe bağlı olarak parametre adları için sütunları kullanarak veri kaynağında güncelleştirmeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OleDbCommand nesneyi alır.
QuoteIdentifier(String, OleDbConnection)	Doğru katalog örneğinde tırnak içine alınmamış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru tırnak içine alınmış biçimini döndürür. Bu, tanımlayıcıdaki ekli tırnakların doğru şekilde kaçmasını içerir.
QuoteIdentifier(String)	Doğru katalog örneğinde tırnak içine alınmamış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru tırnak içine alınmış biçimini döndürür. Bu, tanımlayıcıdaki ekli tırnakların doğru şekilde kaçmasını içerir.
UnquoteIdentifier(String, OleDbConnection)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru ve tırnak içine alınmamış biçimini döndürür. Bu, tanımlayıcıdaki ekli tırnakların doğru şekilde kaçışını kaldırmayı içerir.
UnquoteIdentifier(String)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru ve tırnak içine alınmamış biçimini döndürür. Bu, tanımlayıcıdaki ekli tırnakların doğru şekilde kaçışını kaldırmayı içerir.

Ayrıca bkz.

• CommandBuilders ile Komut Oluşturma