OdbcCommandBuilder Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-rc.2.24473.5

ile ilişkili veri kaynağında yapılan DataSet değişiklikleri uzlaştırmak için kullanılan tek tablolu komutları otomatik olarak oluşturur. Bu sınıf devralınamaz.

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

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

type OdbcCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder

Devralma

Object

MarshalByRefObject

Component

DbCommandBuilder

OdbcCommandBuilder

Örnekler

Aşağıdaki örnekte, veri kaynağından satır seçmek için ve OdbcConnectionile OdbcDataAdapter birlikte kullanılırOdbcCommand. Ö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 OdbcCommandBuilderoluşturur.

public static DataSet SelectOdbcSrvRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter = new OdbcDataAdapter();
        adapter.SelectCommand =
            new OdbcCommand(queryString, connection);
        OdbcCommandBuilder builder =
            new OdbcCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        //Without the OdbcCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);
    }
    return dataSet;
}

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

    Dim dataSet As New DataSet()

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter()
        adapter.SelectCommand = _
            New OdbcCommand(queryString, connection)
        Dim builder As New OdbcCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

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

    Return dataSet
End Function

Açıklamalar

, OdbcDataAdapter veri kaynağıyla ilişkilendirilmiş bir DataSet ile yapılan değişiklikleri mutabık hale getirmek için gereken SQL deyimlerini otomatik olarak oluşturmaz. Ancak, özelliğini OdbcDataAdapterayarlayarak SelectCommand tek tablolu güncelleştirmeler için SQL deyimleri oluşturan bir OdbcCommandBuilder nesnesi oluşturabilirsiniz. ardından OdbcCommandBuilder , ayarlamadığınız ek SQL deyimlerini oluşturur.

ile karşılık gelen OdbcCommandBuilder arasındaki ilişki OdbcDataAdapter her zaman bire bir olur. Bu yazışmayı oluşturmak için nesnesinin OdbcDataAdapterOdbcCommandBuilder özelliğini ayarlarsınız. Bu, öğesinin OdbcCommandBuilder kendisini etkileyen olayların çıkışını RowUpdating üreten bir dinleyici olarak kaydetmesine DataSetneden olur.

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

Not

özelliğe atanan SelectCommand SELECT deyimi diğer adlar kullanıyorsa, sonuçta elde edilen INSERT, UPDATE ve DELETE deyimleri yanlış veya başarısız olabilir. Temel ODBC sürücüsü diğer ad sütun adı için uygun temel sütun adını sağlayamıyorsa (SQL_DESC_BASE_COLUMN_NAME değeri SQLColAttributekullanılarak), oluşturulan INSERT, UPDATE ve DELETE deyimlerinde diğer ad kullanılabilir. Örneğin, Oracle için Microsoft ODBC Sürücüsü temel sütun adı olarak diğer adı döndürür. Bu nedenle, oluşturulan INSERT, UPDATE ve DELETE deyimleri hatalara neden olabilir.

, OdbcCommandBuilder tarafından SelectCommandbaşvuruda bulunan Connection, CommandTimeoutve Transaction özelliklerini de kullanır. Kullanıcı, bu özelliklerden biri veya daha fazlası değiştirilirse veya özelliğin SelectCommand değeri değiştirilirse çağrısı RefreshSchema yapmalıdır. InsertCommandAksi takdirde , UpdateCommandve DeleteCommand özellikleri önceki değerlerini korur.

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

Oluşturucular

OdbcCommandBuilder()	OdbcCommandBuilder sınıfının yeni bir örneğini başlatır.
OdbcCommandBuilder(OdbcDataAdapter)	İlişkili OdbcDataAdapter nesneyle sınıfının yeni bir örneğini OdbcCommandBuilder 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	Bu OdbcCommandBuilder nesnenin SQL deyimleri oluşturacağı nesneyi OdbcDataAdapter 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(OdbcCommand)	içinde OdbcCommand belirtilen saklı yordamdan parametre bilgilerini alır ve belirtilen OdbcCommand 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 OdbcCommand nesneyi alır.
GetDeleteCommand(Boolean)	Veri kaynağında silme işlemleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand 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 OdbcCommand nesneyi alır.
GetInsertCommand(Boolean)	Veri kaynağında eklemeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand 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 OdbcCommand nesneyi alır.
GetUpdateCommand(Boolean)	Veri kaynağında güncelleştirmeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand 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, OdbcConnection)	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, OdbcConnection)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, tanımlayıcıdaki katıştırılmış tırnak işaretleri de dahil olmak üzere tanımlayıcının doğru tırnak içine alınmamış biçimini döndürür.
UnquoteIdentifier(String)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, tanımlayıcıdaki katıştırılmış tırnak işaretleri de dahil olmak üzere tanımlayıcının doğru tırnak içine alınmamış biçimini döndürür.

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