setAutoCommit-Methode (SQLServerConnection)

  • Artikel

JDBC-Treiber herunterladen

Legt für dieses SQLServerConnection-Objekt den aktuellen Modus für automatische Commits auf den angegebenen Zustand fest.

Syntax

  
public void setAutoCommit(boolean value)

Parameter

value

Mit dem Wert TRUE wird der Modus für automatische Commits für die Verbindung aktiviert, und mit dem Wert FALSE wird er deaktiviert.

Ausnahmen

SQLServerException

Bemerkungen

Diese setAutoCommit-Methode wird von der setAutoCommit-Methode in der java.sql.Connection-Schnittstelle angegeben.

Ist für eine Verbindung der Modus für automatische Commits aktiviert, werden alle SQL-Anweisungen als einzelne Transaktionen ausgeführt, und die Commits der SQL-Anweisungen werden als einzelne Transaktionen ausgeführt. Andernfalls werden die SQL-Anweisungen in Transaktionen gruppiert, die mit einem Aufruf der commit- oder der rollback-Methode beendet werden. Der Modus für automatische Commits ist für neue Verbindungen standardmäßig aktiviert.

Der Commit wird ausgeführt, wenn die Anweisung abgeschlossen wird oder die nächste Ausführung durchgeführt wird, je nachdem, welches Ereignis zuerst eintritt. Wenn Anweisungen ein SQLServerResultSet-Objekt zurückgeben, wird die Anweisung abgeschlossen, wenn die letzte Zeile des Ergebnisses abgerufen oder das Resultset geschlossen wurde. In erweiterten Fällen kann eine einzelne Anweisung zusätzlich zu den Ausgabeparameterwerten mehrere Ergebnisse zurückgeben. In diesen Fällen wird der Commit ausgeführt, nachdem alle Ergebnisse und Ausgabeparameterwerte abgerufen wurden.

Ist der Modus für automatische Commits auf false gesetzt, startet der JDBC-Treiber nach jedem Commit implizit eine neue Transaktion.

Hinweis

Wenn diese Methode während einer Transaktion aufgerufen wird, wird ein Commit der Transaktion ausgeführt.

Weitere Informationen

SQLServerConnection-Elemente
SQLServerConnection-Klasse