IStatement.ExecuteBatch Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Sendet einen Batch von Befehlen zur Ausführung an die Datenbank, und wenn alle Befehle erfolgreich ausgeführt werden, wird ein Array von Updateanzahlen zurückgegeben.
[Android.Runtime.Register("executeBatch", "()[I", "GetExecuteBatchHandler:Java.Sql.IStatementInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public int[]? ExecuteBatch ();[<Android.Runtime.Register("executeBatch", "()[I", "GetExecuteBatchHandler:Java.Sql.IStatementInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ExecuteBatch : unit -> int[]Gibt zurück
ein Array von Aktualisierungsanzahlen, die ein Element für jeden Befehl im Batch enthalten. Die Elemente des Arrays werden entsprechend der Reihenfolge sortiert, in der Befehle zum Batch hinzugefügt wurden.
- Attribute
Ausnahmen
wenn beim Zugriff auf die Datenbank ein Fehler auftritt.
Hinweise
Sendet einen Batch von Befehlen zur Ausführung an die Datenbank, und wenn alle Befehle erfolgreich ausgeführt werden, wird ein Array von Updateanzahlen zurückgegeben. Die int Elemente des zurückgegebenen Arrays werden sortiert, um den Befehlen im Batch zu entsprechen, die gemäß der Reihenfolge sortiert werden, in der sie dem Batch hinzugefügt wurden. Die Von der Methode executeBatch zurückgegebenen Elemente im Array können eine der folgenden Sein: <OL<>LI>A-Zahl größer oder gleich Null - gibt an, dass der Befehl erfolgreich verarbeitet wurde und eine Aktualisierungsanzahl ist, die die Anzahl der Zeilen in der Datenbank angibt, die von der Ausführung <von LI>A-Wert SUCCESS_NO_INFO des Befehls betroffen waren - gibt an, dass der Befehl erfolgreich verarbeitet wurde, aber die Anzahl der betroffenen Zeilen unbekannt ist.
Wenn einer der Befehle in einem Batchupdate nicht ordnungsgemäß ausgeführt werden kann, löst diese Methode einen BatchUpdateException, und ein VORGANGstreiber verarbeitet die verbleibenden Befehle im Batch möglicherweise oder nicht weiter. Das Verhalten des Treibers muss jedoch mit einem bestimmten DBMS konsistent sein, entweder immer weiter zu Verarbeiten von Befehlen oder nie zum Verarbeiten von Befehlen. Wenn der Treiber die Verarbeitung nach einem Fehler fortsetzt, enthält das von der Methode BatchUpdateException.getUpdateCounts zurückgegebene Array so viele Elemente, wie im Batch Befehle vorhanden sind, und mindestens eines der Elemente lautet wie folgt:
<LI>A value of EXECUTE_FAILED -- indicates that the command failed to execute erfolgreich and occurs only if a driver continues to process commands after a command failed </OL>
Die möglichen Implementierungen und Rückgabewerte wurden im Java 2 SDK, Standard Edition, Version 1.3, geändert, um die Option aufzunehmen, Befehle in einem Batchupdate weiterhin zu proccessieren, nachdem ein BatchUpdateException Obejct ausgelöst wurde.
In 1.2 hinzugefügt.
Java-Dokumentation für java.sql.Statement.executeBatch().
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.