Data.SqlExpr.TSQLConnection.MaxStmtsPerConn

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property MaxStmtsPerConn: LongWord read FMaxStmtsPerConn;

C++

__property unsigned MaxStmtsPerConn = {read=FMaxStmtsPerConn, nodefault};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TSQLConnection

Description

Indique la limite imposée par le serveur pour le nombre d'instructions prises en charge par une même connexion de base de données.

Quand une connexion est active, consultez MaxStmtsPerConn pour savoir si le serveur de bases de données impose une limite sur le nombre d'instructions pouvant être exécutées avec la connexion en cours. Quand la valeur 0 est attribuée à MaxStmtsPerConn, le serveur n'impose aucune restriction : une même connexion de base de données peut être utilisée pour récupérer plusieurs ensembles de données et exécuter des instructions quand des ensembles de données sont actifs. En revanche, avec une valeur de MaxStmtsPerConn supérieure à 0, le serveur de bases de données limite le nombre d'instructions pouvant être exécutées. Il n'autorise l'ouverture que de MaxStmtsPerConn ensembles de données avec une même connexion et, lorsque le nombre d'ensembles de données est atteint, aucune instruction ne peut être exécutée (par exemple, à l'aide de la méthode Execute).

Par défaut, si la valeur de MaxStmtsPerConn est supérieure à 0, TSQLConnection clone la connexion de base de données quand la limite imposée par le serveur est atteinte. Par exemple, avec la valeur 1 pour MaxStmtsPerConn , la tentative d'ouverture d'un second ensemble de données à l'aide du même composant TSQLConnection conduit ce dernier à établir une deuxième connexion de base de données pour le second ensemble de données. En revanche, si la valeur false est attribuée à AutoClone, TSQLConnection ne clone pas les connexions, mais génère plutôt une exception quand l'application essaie de dépasser la limite MaxStmtsPerConn.

Remarque :  La valeur de MaxStmtsPerConn est valide uniquement si la valeur true est affectée à la propriété Connected.

Voir aussi