DataContext.ExecuteCommand(String, Object[]) Metode

Definisi

Ruang nama:

System.Data.Linq

Rakitan:

System.Data.Linq.dll

Menjalankan perintah SQL langsung pada database.

public:
 int ExecuteCommand(System::String ^ command, ... cli::array <System::Object ^> ^ parameters);

public int ExecuteCommand (string command, params object[] parameters);

member this.ExecuteCommand : string * obj[] -> int

Public Function ExecuteCommand (command As String, ParamArray parameters As Object()) As Integer

Parameter

command

String

Perintah SQL yang akan dijalankan.

parameters

Object[]

Array parameter yang akan diteruskan ke perintah . Perhatikan perilaku berikut:

Jika jumlah objek dalam array kurang dari angka tertinggi yang diidentifikasi dalam string perintah, pengecualian akan dilemparkan.

Jika array berisi objek yang tidak direferensikan dalam string perintah, tidak ada pengecualian yang dilemparkan.

Jika salah satu parameter null, parameter akan dikonversi ke DBNull.Value.

Mengembalikan

Int32

Jumlah baris yang dimodifikasi oleh perintah yang dijalankan.

Contoh

Contoh berikut membuka koneksi dan meneruskan perintah SQL UPDATE ke mesin SQL.

db.ExecuteCommand("UPDATE Products SET UnitPrice = UnitPrice + 1.00");

    db.ExecuteCommand _
("UPDATE Products SET UnitPrice = UnitPrice + 1.00")

Keterangan

Metode ini adalah mekanisme pass-through untuk kasus di mana LINQ ke SQL tidak menyediakan skenario tertentu secara memadai.

Sintaks untuk perintah hampir sama dengan sintaks yang digunakan untuk membuat ADO.NET DataCommand. Satu-satunya perbedaan adalah bagaimana parameter ditentukan. Secara khusus, Anda menentukan parameter dengan mengapitnya dalam kurung kurawal ({...}) dan menghitungnya mulai dari 0. Parameter dikaitkan dengan objek yang sama bernomor dalam array parameter.

ExecuteQuery dan ExecuteCommand memungkinkan Anda menentukan jumlah variabel argumen untuk substitusi parameter. Misalnya, Anda dapat menentukan parameter saat memanggil ExecuteQuery<TResult>:

db.ExecuteQuery<Customer>("SELECT * FROM dbo.Customers WHERE City = {0}", "London");

db.ExecuteQuery(Of Customer)("SELECT * FROM dbo.Customers WHERE City = {0}", "London")

Dan, contoh lain:

db.ExecuteCommand("UPDATE Products SET QuantityPerUnit = {0} WHERE ProductID = {1}", "24 boxes", 5);

db.ExecuteCommand("UPDATE Products SET QuantityPerUnit = {0} WHERE ProductID = {1}", "24 boxes", 5)