DbCommandBuilder Kelas

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Sumber:

DBCommandBuilder.cs

Secara otomatis menghasilkan perintah tabel tunggal yang digunakan untuk merekonsiliasi perubahan yang DataSet dilakukan pada database terkait. Ini adalah kelas abstrak yang hanya dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Component

DbCommandBuilder

Turunan

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

Keterangan

Kelas DbCommandBuilder disediakan untuk kenyamanan penulis penyedia yang membuat penyusun perintah mereka sendiri. Dengan mewarisi dari kelas ini, pengembang dapat menerapkan perilaku spesifik penyedia dalam kode mereka sendiri.

DbDataAdapter tidak secara otomatis menghasilkan pernyataan SQL yang diperlukan untuk merekonsiliasi perubahan yang DataSet dilakukan pada sumber data terkait. Namun, Anda dapat membuat DbCommandBuilder objek untuk secara otomatis menghasilkan pernyataan SQL untuk pembaruan tabel tunggal jika Anda mengatur SelectCommand properti dari DbDataAdapter. Kemudian, setiap pernyataan SQL tambahan yang tidak Anda tetapkan dihasilkan oleh DbCommandBuilder.

mendaftarkan DbCommandBuilder dirinya sebagai pendengar untuk RowUpdating peristiwa setiap kali Anda mengatur DataAdapter properti . Anda hanya dapat mengaitkan satu DbDataAdapter atau DbCommandBuilder objek satu sama lain pada satu waktu.

Untuk menghasilkan pernyataan INSERT, UPDATE, atau DELETE, DbCommandBuilder menggunakan SelectCommand properti untuk mengambil sekumpulan metadata yang diperlukan secara otomatis. Jika Anda mengubah SelectCommand setelah metadata diambil (misalnya, setelah pembaruan pertama), Anda harus memanggil RefreshSchema metode untuk memperbarui metadata.

SelectCommand juga harus mengembalikan setidaknya satu kunci primer atau kolom unik. Jika tidak ada, InvalidOperationException pengecualian dihasilkan, dan perintah tidak dihasilkan.

DbCommandBuilder juga menggunakan properti , CommandTimeout, dan Transaction yang dirujuk ConnectionSelectCommandoleh . Pengguna harus memanggil RefreshSchema jika salah satu properti ini dimodifikasi, atau jika properti itu SelectCommand sendiri diganti. InsertCommandJika tidak, properti , UpdateCommand, dan DeleteCommand mempertahankan nilai sebelumnya.

Jika Anda memanggil Dispose, DbCommandBuilder disasosiasi dari DbDataAdapter, dan perintah yang dihasilkan tidak lagi digunakan.

Konstruktor

DbCommandBuilder()

Menginisialisasi instans baru kelas yang mewarisi dari DbCommandBuilder kelas .

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
CatalogLocation	Mendapatkan atau mengatur untuk instans CatalogLocationDbCommandBuilder kelas .
CatalogSeparator	Mendapatkan atau mengatur string yang digunakan sebagai pemisah katalog untuk instans DbCommandBuilder kelas.
ConflictOption	Menentukan mana yang ConflictOption akan digunakan oleh DbCommandBuilder.
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DataAdapter	Mendapatkan atau mengatur DbDataAdapter objek yang pernyataan Transact-SQL-nya dibuat secara otomatis.
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
QuotePrefix	Mendapatkan atau mengatur karakter awal yang akan digunakan saat menentukan objek database (misalnya, tabel atau kolom) yang namanya berisi karakter seperti spasi atau token yang dipesan.
QuoteSuffix	Mendapatkan atau mengatur karakter akhir yang akan digunakan saat menentukan objek database (misalnya, tabel atau kolom) yang namanya berisi karakter seperti spasi atau token cadangan.
SchemaSeparator	Mendapatkan atau mengatur karakter yang akan digunakan untuk pemisah antara pengidentifikasi skema dan pengidentifikasi lainnya.
SetAllValues	Menentukan apakah semua nilai kolom dalam pernyataan pembaruan disertakan atau hanya yang diubah.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)

Metode

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Memungkinkan implementasi DbCommandBuilder penyedia kelas untuk menangani properti parameter tambahan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh DbCommandBuilder dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDeleteCommand()	Mendapatkan objek yang dihasilkan DbCommand secara otomatis yang diperlukan untuk melakukan penghapusan di sumber data.
GetDeleteCommand(Boolean)	Mendapatkan objek yang dihasilkan DbCommand secara otomatis yang diperlukan untuk melakukan penghapusan di sumber data, secara opsional menggunakan kolom untuk nama parameter.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetInsertCommand()	Mendapatkan objek yang dihasilkan DbCommand secara otomatis yang diperlukan untuk melakukan penyisipan di sumber data.
GetInsertCommand(Boolean)	Mendapatkan objek yang dihasilkan DbCommand secara otomatis yang diperlukan untuk melakukan penyisipan di sumber data, secara opsional menggunakan kolom untuk nama parameter.
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetParameterName(Int32)	Mengembalikan nama parameter yang ditentukan dalam format @p#. Gunakan saat membuat penyusun perintah kustom.
GetParameterName(String)	Mengembalikan nama parameter lengkap, dengan nama parameter parsial.
GetParameterPlaceholder(Int32)	Mengembalikan tempat penampung untuk parameter dalam pernyataan SQL terkait.
GetSchemaTable(DbCommand)	Mengembalikan tabel skema untuk DbCommandBuilder.
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetUpdateCommand()	Mendapatkan objek yang dihasilkan DbCommand secara otomatis yang diperlukan untuk melakukan pembaruan di sumber data.
GetUpdateCommand(Boolean)	Mendapatkan objek yang dihasilkan DbCommand secara otomatis yang diperlukan untuk melakukan pembaruan di sumber data, secara opsional menggunakan kolom untuk nama parameter.
InitializeCommand(DbCommand)	Mengatur ulang CommandTimeoutproperti , Transaction, CommandType, dan UpdateRowSource pada DbCommand.
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
QuoteIdentifier(String)	Mengingat pengidentifikasi yang tidak dikutip dalam kasus katalog yang benar, mengembalikan bentuk pengidentifikasi tersebut yang dikutip dengan benar, termasuk melepaskan tanda kutip yang disematkan dengan benar dalam pengidentifikasi.
RefreshSchema()	Menghapus perintah yang terkait dengan ini DbCommandBuilder.
RowUpdatingHandler(RowUpdatingEventArgs)	Menambahkan penanganan aktivitas untuk peristiwa tersebut RowUpdating .
SetRowUpdatingHandler(DbDataAdapter)	DbCommandBuilder Mendaftarkan untuk menangani RowUpdating peristiwa untuk .DbDataAdapter
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)
UnquoteIdentifier(String)	Mengingat pengidentifikasi yang dikutip, mengembalikan bentuk pengidentifikasi yang tidak dikutip yang benar, termasuk melepaskan kutipan yang disematkan dengan benar dalam pengidentifikasi.

Acara

Disposed

Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)

Lihat juga

• Menghasilkan Perintah dengan CommandBuilders
• Ringkasan ADO.NET