SqlCommandBuilder.GetUpdateCommand Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Overload

GetUpdateCommand()	Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan pembaruan pada database.
GetUpdateCommand(Boolean)	Mendapatkan objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan pembaruan pada database.

GetUpdateCommand()

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand();

public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand ();

override this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand () As SqlCommand

Mengembalikan

SqlCommand

Objek yang dihasilkan SqlCommand secara otomatis yang diperlukan untuk melakukan pembaruan.

Keterangan

Aplikasi dapat menggunakan GetUpdateCommand metode untuk tujuan informasi atau pemecahan masalah karena mengembalikan objek yang SqlCommand akan dijalankan.

Anda juga dapat menggunakan GetUpdateCommand sebagai dasar perintah yang dimodifikasi. Misalnya, Anda dapat memanggil GetUpdateCommand 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, GetUpdateCommand akan tetap menggunakan informasi dari pernyataan sebelumnya, yang mungkin tidak benar. Pernyataan Transact-SQL pertama kali dihasilkan ketika aplikasi memanggil atau UpdateGetUpdateCommand.

Untuk mendapatkan informasi selengkapnya, lihat Menghasilkan Perintah dengan CommandBuilders.

GetUpdateCommand(Boolean)

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand (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 diperlukan untuk melakukan pembaruan.

Keterangan

Aplikasi dapat menggunakan GetUpdateCommand metode untuk tujuan informasi atau pemecahan masalah karena mengembalikan objek yang SqlCommand akan dijalankan.

Anda juga dapat menggunakan GetUpdateCommand sebagai dasar perintah yang dimodifikasi. Misalnya, Anda dapat memanggil GetUpdateCommand 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, GetUpdateCommand akan tetap menggunakan informasi dari pernyataan sebelumnya, yang mungkin tidak benar. Pernyataan Transact-SQL pertama kali dihasilkan ketika aplikasi memanggil atau UpdateGetUpdateCommand.

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.