DbCommandBuilder Sınıf

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

DBCommandBuilder.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, 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

Açıklamalar

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

, DbDataAdapter 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 DbDataAdapterayarlarsanız SelectCommand tek tablolu güncelleştirmeler için sql deyimlerini otomatik olarak oluşturmak üzere bir DbCommandBuilder nesne 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 kendisini 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 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.

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

Oluşturucular

Name	Description
DbCommandBuilder()	sınıfından devralan bir sınıfın yeni bir örneğini DbCommandBuilder başlatır.

Özellikler

Name	Description
CanRaiseEvents	Bileşenin 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ında ayırıcı için kullanılacak karakteri alır veya ayarlar.
SetAllValues	Bir update deyimindeki tüm sütun değerlerinin eklenip eklenmeyeceğini veya yalnızca değiştirilen değerlerin dahil edilip edilmeyeceğini belirtir.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)

Yöntemler

Name	Description
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Sınıfının sağlayıcı uygulamasının DbCommandBuilder ek parametre özelliklerini işlemesine izin verir.
Dispose()	tarafından Componentkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından DbCommandBuilder kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları 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 eklemeler yapmak 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ı verilen 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 Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type 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 Objectbasit 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 bir alıntılanmamış tanımlayıcı verildiğinde, tanımlayıcıdaki eklenmiş tırnakların doğru şekilde kaçması da 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 DbDataAdapteröğesini kaydeder.
ToString()	Varsa, adını Stringiçeren bir Component 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 eklenmiş tırnakların doğru şekilde kaçışını kaldırma da dahil olmak üzere bu tanımlayıcının doğru ve tırnak içine alınmamış biçimini döndürür.

Ekinlikler

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

Ayrıca bkz.

• CommandBuilders ile Komut Oluşturma
• ADO.NET’e Genel Bakış