SqlCommand.EnableOptimizedParameterBinding Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit une valeur indiquant si l’objet de commande doit optimiser les performances des paramètres en désactivant les directions Output et InputOutput lors de l’envoi de la commande au 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

Valeur de propriété

Boolean

Valeur indiquant si l’objet de commande doit optimiser les performances des paramètres en désactivant les directions des paramètres Output et InputOuput lors de l’envoi de la commande au SQL Server. Par défaut, il s’agit de false.

Remarques

Vous devez définir la valeur de cette propriété avant l’exécution de la commande pour qu’elle prenne effet.

Lorsqu’une commande est envoyée au serveur avec des paramètres, une liste des noms de paramètres est envoyée dans le cadre de la soumission. La liste est utilisée sur le serveur pour faire correspondre les paramètres Output et InputOutput aux résultats de l’exécution de la requête afin que les valeurs puissent être retournées à l’appelant. Cette option désactive la construction et l’envoi de la liste des noms de paramètres et, par conséquent, désactive l’utilisation des paramètres Output et InputOutput. Le paramètre de retour n’est pas affecté par cette option.

Une commande envoyée avec cette option modifie la façon dont les paramètres sont gérés sur le serveur, car il n’est pas nécessaire de gérer un mappage de paramètres de sortie. Le résultat de cette modification est que les requêtes avec un grand nombre de paramètres d’entrée peuvent s’exécuter beaucoup plus rapidement.

Le nombre le plus restreint de paramètres pour lesquels cela prend effet dépend de la situation individuelle et doit être détecté en mesurant la durée des requêtes avec et sans l’option activée. Toute requête avec plus de 24 paramètres peut afficher une durée de requête globale inférieure. Il est peu probable que les requêtes dont le nombre de paramètres est inférieur à 24 affichent une différence.

Notes

Si l’option est activée et qu’un paramètre avec Direction Output ou InputOutput est présent dans la collection Parameters, une exception InvalidOperationException est levée lors de l’exécution de la commande.