OdbcCommandBuilder Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-preview.3.24172.9

Sumber:

OdbcCommandBuilder.cs

Secara otomatis menghasilkan perintah tabel tunggal yang digunakan untuk mendamaikan perubahan yang DataSet dilakukan pada sumber data terkait. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Component

DbCommandBuilder

OdbcCommandBuilder

Contoh

Contoh berikut menggunakan OdbcCommand, bersama dengan OdbcDataAdapter dan OdbcConnection, untuk memilih baris dari sumber data. Contohnya diteruskan sebagai inisialisasi DataSet, string koneksi, string kueri yang merupakan pernyataan SQL SELECT, dan string yang merupakan nama tabel sumber data. Contohnya kemudian membuat OdbcCommandBuilder.

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

Keterangan

OdbcDataAdapter tidak secara otomatis menghasilkan pernyataan SQL yang diperlukan untuk mendamaikan perubahan yang dilakukan pada sumber data yang DataSet terkait. Namun, Anda dapat membuat OdbcCommandBuilder objek yang menghasilkan pernyataan SQL untuk pembaruan tabel tunggal dengan mengatur SelectCommand properti .OdbcDataAdapter OdbcCommandBuilder kemudian menghasilkan pernyataan SQL tambahan yang tidak Anda tetapkan.

Hubungan antara dan OdbcDataAdapter yang sesuai OdbcCommandBuilder selalu satu-ke-satu. Untuk membuat korespondensi ini, Anda mengatur OdbcDataAdapter properti OdbcCommandBuilder objek . Ini menyebabkan OdbcCommandBuilder mendaftarkan dirinya sebagai pendengar, yang menghasilkan output RowUpdating peristiwa yang memengaruhi DataSet.

Untuk menghasilkan pernyataan INSERT, UPDATE, atau DELETE, OdbcCommandBuilder properti menggunakan SelectCommand untuk mengambil sekumpulan metadata yang diperlukan. Jika Anda mengubah nilai SelectCommand setelah metadata diambil, seperti setelah pembaruan pertama, Anda kemudian harus memanggil RefreshSchema metode untuk memperbarui metadata.

Catatan

Jika pernyataan SELECT yang ditetapkan ke SelectCommand properti menggunakan nama kolom alias, pernyataan INSERT, UPDATE, dan DELETE yang dihasilkan mungkin tidak akurat atau gagal. Jika driver ODBC yang mendasar tidak dapat memberikan nama kolom dasar yang sesuai untuk nama kolom alias (menggunakan nilai SQLColAttributeSQL_DESC_BASE_COLUMN_NAME ), nama alias dapat digunakan dalam pernyataan INSERT, UPDATE, dan DELETE yang dihasilkan. Misalnya, Driver Microsoft ODBC untuk Oracle mengembalikan nama alias sebagai nama kolom dasar. Oleh karena itu, pernyataan INSERT, UPDATE, dan DELETE yang dihasilkan akan menyebabkan kesalahan.

OdbcCommandBuilder juga menggunakan Connectionproperti , CommandTimeout, dan Transaction yang dirujuk SelectCommandoleh . Pengguna harus memanggil RefreshSchema jika satu atau beberapa properti ini dimodifikasi, atau jika nilai properti itu SelectCommand sendiri diubah. InsertCommandJika tidak, properti , UpdateCommand, dan DeleteCommand mempertahankan nilai sebelumnya.

Jika Anda memanggil Dispose, OdbcCommandBuilder dikaitkan dari OdbcDataAdapter, dan perintah yang dihasilkan tidak lagi digunakan.

Konstruktor

OdbcCommandBuilder()	Menginisialisasi instans baru kelas OdbcCommandBuilder.
OdbcCommandBuilder(OdbcDataAdapter)	Menginisialisasi instans OdbcCommandBuilder baru kelas dengan objek terkait OdbcDataAdapter .

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
CatalogLocation	Mendapatkan atau mengatur untuk instans CatalogLocationDbCommandBuilder kelas. (Diperoleh dari DbCommandBuilder)
CatalogSeparator	Mendapatkan atau mengatur string yang digunakan sebagai pemisah katalog untuk instans DbCommandBuilder kelas. (Diperoleh dari DbCommandBuilder)
ConflictOption	Menentukan mana yang ConflictOption akan digunakan oleh DbCommandBuilder. (Diperoleh dari DbCommandBuilder)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DataAdapter	Mendapatkan atau mengatur OdbcDataAdapter objek yang objek ini OdbcCommandBuilder akan menghasilkan pernyataan SQL.
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 atau karakter yang akan digunakan saat menentukan objek database (misalnya, tabel atau kolom) yang namanya berisi karakter seperti spasi atau token cadangan. (Diperoleh dari DbCommandBuilder)
QuoteSuffix	Mendapatkan atau mengatur karakter akhir atau karakter yang akan digunakan saat menentukan objek database (misalnya, tabel atau kolom) yang namanya berisi karakter seperti spasi atau token cadangan. (Diperoleh dari DbCommandBuilder)
SchemaSeparator	Mendapatkan atau mengatur karakter yang akan digunakan untuk pemisah antara pengidentifikasi skema dan pengidentifikasi lainnya. (Diperoleh dari DbCommandBuilder)
SetAllValues	Menentukan apakah semua nilai kolom dalam pernyataan pembaruan disertakan atau hanya yang diubah. (Diperoleh dari DbCommandBuilder)
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. (Diperoleh dari DbCommandBuilder)
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)
DeriveParameters(OdbcCommand)	Mengambil informasi parameter dari prosedur tersimpan yang ditentukan dalam OdbcCommand dan mengisi Parameters kumpulan objek yang ditentukan OdbcCommand .
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang DbCommandBuilder digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbCommandBuilder)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDeleteCommand()	Mendapatkan objek yang dihasilkan OdbcCommand secara otomatis yang diperlukan untuk melakukan penghapusan di sumber data.
GetDeleteCommand(Boolean)	Mendapatkan objek yang dihasilkan OdbcCommand secara otomatis yang diperlukan untuk melakukan penghapusan di sumber data.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetInsertCommand()	Mendapatkan objek yang dihasilkan OdbcCommand secara otomatis yang diperlukan untuk melakukan penyisipan di sumber data.
GetInsertCommand(Boolean)	Mendapatkan objek yang dihasilkan OdbcCommand secara otomatis yang diperlukan untuk melakukan penyisipan di sumber data.
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. (Diperoleh dari DbCommandBuilder)
GetParameterName(String)	Mengembalikan nama parameter lengkap, dengan nama parameter parsial. (Diperoleh dari DbCommandBuilder)
GetParameterPlaceholder(Int32)	Mengembalikan tempat penampung untuk parameter dalam pernyataan SQL terkait. (Diperoleh dari DbCommandBuilder)
GetSchemaTable(DbCommand)	Mengembalikan tabel skema untuk DbCommandBuilder. (Diperoleh dari DbCommandBuilder)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetUpdateCommand()	Mendapatkan objek yang dihasilkan OdbcCommand secara otomatis yang diperlukan untuk melakukan pembaruan di sumber data.
GetUpdateCommand(Boolean)	Mendapatkan objek yang dihasilkan OdbcCommand secara otomatis yang diperlukan untuk melakukan pembaruan di sumber data.
InitializeCommand(DbCommand)	Mengatur ulang CommandTimeoutproperti , Transaction, CommandType, dan UpdateRowSource pada DbCommand. (Diperoleh dari DbCommandBuilder)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang 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 kutipan yang benar dari pengidentifikasi tersebut. Ini termasuk melarikan diri dengan benar setiap tanda kutip yang disematkan dalam pengidentifikasi.
QuoteIdentifier(String, OdbcConnection)	Mengingat pengidentifikasi yang tidak dikutip dalam kasus katalog yang benar, mengembalikan bentuk kutipan yang benar dari pengidentifikasi tersebut. Ini termasuk melarikan diri dengan benar setiap tanda kutip yang disematkan dalam pengidentifikasi.
RefreshSchema()	Menghapus perintah yang terkait dengan ini DbCommandBuilder. (Diperoleh dari DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Menambahkan penanganan aktivitas untuk peristiwa tersebut RowUpdating . (Diperoleh dari DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	DbCommandBuilder Mendaftarkan untuk menangani RowUpdating peristiwa untuk DbDataAdapter. (Diperoleh dari DbCommandBuilder)
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 tanda kutip yang disematkan dengan benar dalam pengidentifikasi.
UnquoteIdentifier(String, OdbcConnection)	Mengingat pengidentifikasi yang dikutip, mengembalikan bentuk pengidentifikasi yang tidak dikutip yang benar, termasuk melepaskan tanda kutip 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