SqlCommand.EnableOptimizedParameterBinding Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Komutu SQL Server gönderirken Output ve InputOutput yönergelerini devre dışı bırakarak komut nesnesinin parametre performansını iyileştirmesi gerekip gerekmediğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

Komutu SQL Server gönderirken Output ve InputOuput parametre yönlerini devre dışı bırakarak komut nesnesinin parametre performansını iyileştirmesi gerekip gerekmediğini belirten bir değer. Varsayılan değer: false.

Açıklamalar

Etkili olması için komut yürütülmeden önce bu özelliğin değerini ayarlamanız gerekir.

Sunucuya parametrelerle bir komut gönderildiğinde, göndermenin bir parçası olarak parametre adlarının bir listesi gönderilir. Liste, çıkış ve InputOutput parametrelerini sorgu yürütme sonuçlarıyla eşleştirmek için sunucuda kullanılır, böylece değerler çağırana döndürülebilir. Bu seçenek parametre adı listesinin oluşturulmasını ve gönderilmesini devre dışı bırakır ve sonuç olarak Output ve InputOutput parametrelerinin kullanımını devre dışı bırakır. Dönüş parametresi bu seçenekten etkilenmez.

Bu seçenekle gönderilen bir komut, parametrelerin sunucuda işlenme şeklini değiştirir, çünkü bir çıkış parametresi eşlemesinin korunmasına gerek yoktur. Bu değişikliğin sonucu, çok sayıda giriş parametresine sahip sorguların çok daha hızlı yürütülebileceğidir.

Bunun etkili olacağı en az sayıda parametre, tek tek duruma bağlıdır ve sorgu süresi seçeneği etkinken ve etkinleştirilmeden ölçülerek algılanmalıdır. 24'ten fazla parametresi olan tüm sorgular genel olarak daha düşük sorgu süresi gösterebilir. Parametre sayısı 24'ten düşük olan sorguların fark gösterme olasılığı düşüktür.

Not

Seçenek etkinse ve Parameters koleksiyonunda Direction Output veya InputOutput içeren bir parametre varsa, komut yürütürken InvalidOperationException oluşturulur.