SqlCommand.EnableOptimizedParameterBinding Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau menetapkan nilai yang menunjukkan apakah objek perintah harus mengoptimalkan performa parameter dengan menonaktifkan arah Output dan InputOutput saat mengirimkan perintah ke SQL Server.

public:
 property bool EnableOptimizedParameterBinding { bool get(); void set(bool value); };

public bool EnableOptimizedParameterBinding { get; set; }

member this.EnableOptimizedParameterBinding : bool with get, set

Public Property EnableOptimizedParameterBinding As Boolean

Nilai Properti

Boolean

Nilai yang menunjukkan apakah objek perintah harus mengoptimalkan performa parameter dengan menonaktifkan arah parameter Output dan InputOuput saat mengirimkan perintah ke SQL Server. Defaultnya adalah false.

Keterangan

Anda harus mengatur nilai untuk properti ini sebelum perintah dijalankan agar berlaku.

Ketika perintah dikirimkan ke server dengan parameter daftar nama parameter dikirim sebagai bagian dari pengiriman. Daftar ini digunakan di server untuk mencocokkan parameter Output dan InputOutput dengan hasil eksekusi kueri sehingga nilai dapat dikembalikan ke pemanggil. Opsi ini menonaktifkan konstruksi dan pengiriman daftar nama parameter dan sebagai konsekuensinya menonaktifkan penggunaan parameter Output dan InputOutput. Parameter pengembalian tidak terpengaruh oleh opsi ini.

Perintah yang dikirim dengan opsi ini mengubah cara parameter ditangani di server, karena tidak perlu mempertahankan peta parameter output. Hasil dari perubahan ini adalah bahwa kueri dengan sejumlah besar parameter input dapat dijalankan jauh lebih cepat.

Jumlah parameter terkecil di mana ini akan berlaku tergantung pada situasi individu dan harus dideteksi dengan mengukur durasi kueri dengan dan tanpa opsi diaktifkan. Setiap kueri dengan lebih dari 24 parameter dapat menunjukkan durasi kueri keseluruhan yang lebih rendah. Kueri dengan jumlah parameter yang lebih rendah dari 24 tidak mungkin menunjukkan perbedaan.

Catatan

Jika opsi diaktifkan dan parameter dengan Output Arah atau InputOutput ada dalam koleksi Parameter, InvalidOperationException akan dilemparkan saat perintah dijalankan.