OleDbCommandBuilder 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.2.24473.5

bir veritabanında yapılan değişiklikleri ilişkili veritabanıyla 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 , ve ile birlikte OleDbDataAdapterOleDbConnectionkullanılır. Örnek, başlatılan DataSet, 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 içinde yapılan değişiklikleri ilişkili veri kaynağıyla 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 otomatik olarak SQL deyimleri oluşturmak üzere bir OleDbCommandBuilder nesnesi 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 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 SelectCommandbaşvuruda bulunan Connection, CommandTimeoutve Transaction özelliklerini de kullanır. Kullanıcı, bu özelliklerden biri veya daha fazlası değiştirilirse veya kendisi değiştirilirse SelectCommand çağrısı RefreshSchema yapmalıdır. 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

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

Özellikler

CanRaiseEvents	Bileşenin bir olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
CatalogLocation	sınıfının bir örneği DbCommandBuilder için öğesini CatalogLocation alır veya ayarlar. (Devralındığı yer: DbCommandBuilder)
CatalogSeparator	Sınıfının bir örneği için katalog ayırıcısı olarak kullanılan bir dizeyi DbCommandBuilder alır veya ayarlar. (Devralındığı yer: DbCommandBuilder)
ConflictOption	ConflictOption tarafından DbCommandBuilderhangilerinin kullanılacağını belirtir. (Devralındığı yer: DbCommandBuilder)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DataAdapter	SQL deyimlerinin otomatik olarak oluşturulduğu nesneyi OleDbDataAdapter 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)
QuotePrefix	Adları boşluk veya ayrılmış belirteç gibi karakterler içeren veritabanı nesnelerini (örneğin, tablolar veya sütunlar) belirtirken kullanılacak başlangıç karakterini veya karakterleri alır veya ayarlar. (Devralındığı yer: DbCommandBuilder)
QuoteSuffix	Adları boşluk veya ayrılmış belirteç gibi karakterler içeren veritabanı nesnelerini (örneğin, tablolar veya sütunlar) belirtirken kullanılacak bitiş karakterini veya karakterleri alır veya ayarlar. (Devralındığı yer: DbCommandBuilder)
SchemaSeparator	Şema tanımlayıcısı ile diğer tanımlayıcılar arasındaki ayırıcı için kullanılacak karakteri alır veya ayarlar. (Devralındığı yer: DbCommandBuilder)
SetAllValues	Bir update deyimindeki tüm sütun değerlerinin dahil edilip edilmeyeceğini veya yalnızca değiştirilen değerlerin eklenip eklenmeyeceğini belirtir. (Devralındığı yer: DbCommandBuilder)
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)

Yöntemler

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	sınıfının sağlayıcı uygulamasının DbCommandBuilder ek parametre özelliklerini işlemesine izin verir. (Devralındığı yer: DbCommandBuilder)
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)
DeriveParameters(OleDbCommand)	içinde OleDbCommand belirtilen saklı yordamdan parametre bilgilerini alır ve belirtilen OleDbCommand nesnenin Parameters koleksiyonunu doldurur.
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	DbCommandBuilder 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: DbCommandBuilder)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
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.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
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.
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)
GetParameterName(Int32)	Belirtilen parametrenin adını biçiminde @p#döndürür. Özel komut oluşturucu oluştururken kullanın. (Devralındığı yer: DbCommandBuilder)
GetParameterName(String)	Kısmi parametre adı verilip tam parametre adını döndürür. (Devralındığı yer: DbCommandBuilder)
GetParameterPlaceholder(Int32)	İlişkili SQL deyimindeki parametresi için yer tutucuyu döndürür. (Devralındığı yer: DbCommandBuilder)
GetSchemaTable(DbCommand)	için DbCommandBuilderşema tablosunu döndürür. (Devralındığı yer: DbCommandBuilder)
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)
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.
InitializeCommand(DbCommand)	üzerindeki DbCommand, Transaction, CommandTypeve UpdateRowSource özelliklerini sıfırlarCommandTimeout. (Devralındığı yer: DbCommandBuilder)
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 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)
QuoteIdentifier(String, OleDbConnection)	Doğru katalog durumundaki 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 eklenmiş tırnaklardan doğru şekilde kaçışı içerir.
QuoteIdentifier(String)	Doğru katalog durumundaki 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 eklenmiş tırnaklardan doğru şekilde kaçışı içerir.
RefreshSchema()	Bu DbCommandBuilderile ilişkili komutları temizler. (Devralındığı yer: DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Olay için bir olay işleyicisi RowUpdating ekler. (Devralındığı yer: DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	DbCommandBuilder olayını işlemek RowUpdating için öğesini kaydederDbDataAdapter. (Devralındığı yer: DbCommandBuilder)
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)
UnquoteIdentifier(String, OleDbConnection)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru tırnak içine alınmamış biçimini döndürür. Bu, tanımlayıcıdaki eklenmiş 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 tırnak içine alınmamış biçimini döndürür. Bu, tanımlayıcıdaki eklenmiş tırnakların doğru şekilde kaçışını kaldırmayı içerir.

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)

Ayrıca bkz.

• CommandBuilders ile Komut Oluşturma