SqlCommandBuilder.GetInsertCommand Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.9.0

Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database.

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.

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.

GetInsertCommand()

Sumber:

System.Data.SqlClient.notsupported.cs

Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public System.Data.SqlClient.SqlCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

Mengembalikan

SqlCommand

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.

Lihat juga

• Menyambungkan dan Mengambil Data di ADO.NET
• Menggunakan Penyedia Data .NET Framework untuk SQL Server
• Ringkasan ADO.NET

GetInsertCommand(Boolean)

Sumber:

System.Data.SqlClient.notsupported.cs

Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan penyisipan pada database.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parameter

useColumnsForParameterNames

Boolean

Jika true, hasilkan nama parameter yang cocok dengan nama kolom jika memungkinkan. Jika false, hasilkan @p1, @p2, dan sebagainya.

Mengembalikan

SqlCommand

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 berhasil hanya 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 ParameterNamePattern yang 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.

Lihat juga

• Menyambungkan dan Mengambil Data di ADO.NET
• Menggunakan Penyedia Data .NET Framework untuk SQL Server
• Ringkasan ADO.NET