Data.SqlExpr.TSQLConnection.ActiveStatements

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property ActiveStatements: LongWord read FActiveStatements;

C++

__property unsigned ActiveStatements = {read=FActiveStatements, nodefault};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TSQLConnection

Beschreibung

Gibt an, wie viele Anweisungen derzeit auf dem Datenbankserver ausgeführt werden.

Mit ActiveStatements können Sie feststellen, wie viele Anweisungen derzeit über die Datenbankverbindung ausgeführt werden. Während eine Datenmenge vorbereitet wird, erstellt sie eine aktive Anweisung, die erhalten bleibt, bis die Vorbereitung deaktiviert wird. Wenn Sie die Eigenschaft Prepared einer Datenmenge auf true setzen, bleibt die Anweisung aktiv, bis Prepared auf false gesetzt wird. Wenn Prepared false ist, bereitet die Datenmenge ihre Anweisung implizit vor, sobald sie geöffnet wird. Die Anweisung bleibt aktiv, bis Sie die Datenmenge wieder schließen. Auch bei der Ausführung einer SQL-Anweisung (z.B. mit der Methode Execute) wird vorübergehend eine aktive Anweisung erzeugt, bis die Ausführung beendet ist.

Mit Hilfe von ActiveStatements können Sie prüfen, ob eine Anwendung die vom Server vorgegebene Höchstzahl an aktiven Anweisungen erreicht hat, die für jede Verbindung erlaubt sind (Eigenschaft MaxStmtsPerConn). Dies ist besonders wichtig, wenn AutoClone false ist, da die Überschreitung von MaxStmtsPerConn in diesem Fall eine Exception auslöst. Um die vorgegebene Höchstzahl nicht zu überschreiten, sollten Sie keine Datenmengen öffnen oder SQL-Anweisungen ausführen, wenn ActiveStatements den gleichen Wert hat wie MaxStmtsPerConn (es sei denn, MaxStmtsPerConn ist 0).

Siehe auch