DbCommandBuilder Sınıf

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DBCommandBuilder.cs

'de 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, yalnızca devralınabilen soyut bir sınıftır.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

Devralma

Object

MarshalByRefObject

Component

DbCommandBuilder

Türetilmiş

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

Açıklamalar

sınıfı DbCommandBuilder , sağlayıcı yazarlarının kendi komut oluşturucularını oluşturması için sağlanır. Geliştiriciler bu sınıftan devralarak kendi kodlarında sağlayıcıya özgü davranışlar uygulayabilir.

, DbDataAdapter 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 DbDataAdapterayarlarsanız SelectCommand tek tablolu güncelleştirmeler için otomatik olarak SQL deyimleri oluşturmak üzere bir DbCommandBuilder nesnesi oluşturabilirsiniz. Ardından, ayarlamadığınız tüm ek SQL deyimleri tarafından DbCommandBuilderoluşturulur.

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

INSERT, UPDATE veya DELETE deyimleri oluşturmak için, DbCommandBuilder gerekli bir meta veri kümesini otomatik olarak 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.

ayrıca SelectCommand en az bir birincil anahtar veya benzersiz sütun döndürmelidir. Yoksa bir InvalidOperationException özel durum oluşturulur ve komutlar oluşturulmaz.

, DbCommandBuilder tarafından SelectCommandbaşvuruda bulunan Connection, CommandTimeoutve Transaction özelliklerini de kullanır. Kullanıcı, bu özelliklerden herhangi biri 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 , DbCommandBuilder ile ilişkilendirilmez DbDataAdapterve oluşturulan komutlar artık kullanılmaz.

Oluşturucular

DbCommandBuilder()

sınıfından devralan bir sınıfın yeni bir örneğini DbCommandBuilder 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.
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.
ConflictOption	ConflictOption tarafından DbCommandBuilderhangilerinin kullanılacağını belirtir.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DataAdapter	Transact-SQL deyimlerinin otomatik olarak oluşturulduğu nesneyi DbDataAdapter 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.
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.
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.
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.
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.
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)
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.
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 DbCommand nesneyi alır.
GetDeleteCommand(Boolean)	İsteğe bağlı olarak parametre adları için sütunları kullanarak veri kaynağında silme işlemleri gerçekleştirmek için gereken otomatik olarak oluşturulan DbCommand 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 DbCommand nesneyi alır.
GetInsertCommand(Boolean)	İsteğe bağlı olarak parametre adları için sütunları kullanarak veri kaynağında eklemeleri gerçekleştirmek için gereken otomatik olarak oluşturulan DbCommand nesneyi alır.
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)
GetParameterName(Int32)	Belirtilen parametrenin adını biçiminde @p#döndürür. Özel komut oluşturucu oluştururken kullanın.
GetParameterName(String)	Kısmi parametre adı verilip tam parametre adını döndürür.
GetParameterPlaceholder(Int32)	İlişkili SQL deyimindeki parametresi için yer tutucuyu döndürür.
GetSchemaTable(DbCommand)	için DbCommandBuilderşema tablosunu döndürür.
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 DbCommand 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 DbCommand nesneyi alır.
InitializeCommand(DbCommand)	üzerindeki DbCommand, Transaction, CommandTypeve UpdateRowSource özelliklerini sıfırlarCommandTimeout.
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)
QuoteIdentifier(String)	Doğru katalog durumundaki tırnak içine alınmamış bir tanımlayıcı verildiğinde, tanımlayıcıdaki katıştırılmış tırnak işaretleri de dahil olmak üzere bu tanımlayıcının doğru tırnak içine alınmış biçimini döndürür.
RefreshSchema()	Bu DbCommandBuilderile ilişkili komutları temizler.
RowUpdatingHandler(RowUpdatingEventArgs)	Olay için bir olay işleyicisi RowUpdating ekler.
SetRowUpdatingHandler(DbDataAdapter)	DbCommandBuilder olayını işlemek RowUpdating için öğesini kaydederDbDataAdapter.
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)	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
• ADO.NET’e Genel Bakış