SqlCommandBuilder.GetInsertCommand Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
| GetInsertCommand() |
Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database. |
| GetInsertCommand(Boolean) |
Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database. |
GetInsertCommand()
Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand();public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand ();member this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetInsertCommand () As SqlCommandMengembalikan
Objek yang dihasilkan SqlCommand secara otomatis diperlukan untuk melakukan penyisipan.
Keterangan
Aplikasi dapat menggunakan GetInsertCommand metode untuk tujuan informasi atau pemecahan masalah karena mengembalikan objek yang SqlCommand akan dijalankan.
Anda juga dapat menggunakan GetInsertCommand sebagai dasar perintah yang dimodifikasi. Misalnya, Anda dapat memanggil GetInsertCommand dan memodifikasi CommandTimeout nilai, lalu secara eksplisit mengaturnya pada SqlDataAdapter.
Setelah pernyataan Transact-SQL pertama kali dibuat, aplikasi harus secara eksplisit memanggil RefreshSchema jika mengubah pernyataan dengan cara apa pun. Jika tidak, GetInsertCommand akan tetap menggunakan informasi dari pernyataan sebelumnya, yang mungkin tidak benar. Pernyataan Transact-SQL pertama kali dihasilkan ketika aplikasi memanggil atau UpdateGetInsertCommand.
Untuk mendapatkan informasi selengkapnya, lihat Menghasilkan Perintah dengan CommandBuilders.
Berlaku untuk
GetInsertCommand(Boolean)
Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);member this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommandParameter
- useColumnsForParameterNames
- Boolean
Jika true, buat nama parameter yang cocok dengan nama kolom jika memungkinkan. Jika false, hasilkan @p1, @p2, dan sebagainya.
Mengembalikan
Objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan.
Keterangan
Aplikasi dapat menggunakan GetInsertCommand metode untuk tujuan informasi atau pemecahan masalah karena mengembalikan objek yang SqlCommand akan dijalankan.
Anda juga dapat menggunakan GetInsertCommand sebagai dasar perintah yang dimodifikasi. Misalnya, Anda dapat memanggil GetInsertCommand dan memodifikasi CommandTimeout nilai, lalu secara eksplisit mengaturnya pada SqlDataAdapter.
Setelah pernyataan Transact-SQL pertama kali dibuat, aplikasi harus secara eksplisit memanggil RefreshSchema jika mengubah pernyataan dengan cara apa pun. Jika tidak, GetInsertCommand akan tetap menggunakan informasi dari pernyataan sebelumnya, yang mungkin tidak benar. Pernyataan Transact-SQL pertama kali dihasilkan ketika aplikasi memanggil atau UpdateGetInsertCommand.
Perilaku default, saat menghasilkan nama parameter, adalah menggunakan @p1, , @p2dan sebagainya untuk berbagai parameter. Meneruskan trueuseColumnsForParameterNames parameter memungkinkan Anda memaksa OleDbCommandBuilder untuk menghasilkan parameter berdasarkan nama kolom sebagai gantinya. Ini hanya berhasil jika kondisi berikut terpenuhi:
yang ParameterNameMaxLength dikembalikan dari panggilan metode GetSchema dan ditemukan dalam DataSourceInformation koleksi telah ditentukan dan panjangnya sama dengan atau lebih besar dari nama parameter yang dihasilkan.
Nama parameter yang dihasilkan memenuhi kriteria yang ditentukan dalam yang ParameterNamePattern dikembalikan dari panggilan metode GetSchema dan ditemukan dalam DataSourceInformation ekspresi reguler koleksi.
Yang ParameterMarkerFormat dikembalikan dari panggilan metode GetSchema dan ditemukan dalam DataSourceInformation koleksi ditentukan.
Untuk mendapatkan informasi selengkapnya, lihat Menghasilkan Perintah dengan CommandBuilders.