Data.SqlExpr.TSQLConnection.ActiveStatements
Delphi
property ActiveStatements: LongWord read FActiveStatements;
C++
__property unsigned ActiveStatements = {read=FActiveStatements, nodefault};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
property | public | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | TSQLConnection |
Description
Indique le nombre d'instructions actives associées au serveur de bases de données.
Consultez ActiveStatements pour connaître le nombre d'instructions en cours d'exécution à l'aide de la connexion de base de données. Quand un ensemble de données est préparé, il crée une instruction active qui dure jusqu'à ce que la préparation de l'ensemble de données soit annulée. Si vous attribuez la valeur true à la propriété Prepared d'un ensemble de données, l'instruction reste active jusqu'à ce que vous attribuiez la valeur false à cette propriété. Dans ce cas, l'ensemble de données prépare explicitement son instruction quand vous ouvrez cet ensemble, et il reste actif jusqu'à ce que vous le fermiez. En outre, l'exécution d'une instruction SQL (par exemple, à l'aide de la méthode Execute) crée une instruction temporaire, qui reste active jusqu'à la fin de l'exécution de l'instruction.
Utilisez ActiveStatements pour vérifier si une application a atteint la limite imposée par le serveur sur le nombre d'instructions actives autorisées pour une connexion (propriété MaxStmtsPerConn). Ceci est particulièrement important si la valeur false est attribuée à AutoClone. En effet, dans ce cas, si vous dépassez la valeur MaxStmtsPerConn, la connexion SQL déclenche une exception. Pour éviter de dépasser la limite imposée par le serveur, n'ouvrez aucun ensemble de données et n'exécutez aucune instruction SQL quand ActiveStatements est identique à MaxStmtsPerConn (sauf si la valeur 0 est attribuée à MaxStmtsPerConn).