言語

IStatement.ExecuteBatch メソッド

定義

実行のためにコマンドのバッチをデータベースに送信し、すべてのコマンドが正常に実行された場合は、更新カウントの配列を返します。

[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[]

返品

Int32[]

バッチ内のコマンドごとに 1 つの要素を含む更新カウントの配列。 配列の要素は、コマンドがバッチに追加された順序に従って順序付けられます。

属性

例外

データベースへのアクセス中にエラーが発生した場合は〘。

注釈

実行のためにコマンドのバッチをデータベースに送信し、すべてのコマンドが正常に実行された場合は、更新カウントの配列を返します。 返される配列の int 要素は、バッチ内のコマンドに対応するように並べ替えられました。これは、バッチに追加された順序に従って順序付けられます。 メソッド executeBatchによって返される配列内の要素は、<OL><LI>0 以上の数値のいずれかになります。コマンドが正常に処理され、更新カウントであることを示します。 コマンドの実行によって影響を受けたデータベース内の行数を指定<LI>SUCCESS_NO_INFOの値は、コマンドが正常に処理されたが、影響を受ける行の数が不明であることを示します

バッチ更新のコマンドの 1 つが正常に実行されない場合、このメソッドは BatchUpdateExceptionをスローし、JDBC ドライバーはバッチ内の残りのコマンドの処理を続行する場合と実行しない場合があります。 ただし、ドライバーの動作は、常にコマンドの処理を続けるか、コマンドの処理を続けずに、特定の DBMS と一致している必要があります。 エラーが発生した後もドライバーが処理を続行する場合、メソッド BatchUpdateException.getUpdateCounts によって返される配列には、バッチ内のコマンドと同じ数の要素が含まれます。少なくとも 1 つの要素は次のようになります。

<LI>EXECUTE_FAILED の値 -- コマンドが正常に実行できなかったことを示し、コマンドが失敗した後もドライバーがコマンドの処理を続行した場合にのみ発生 </OL>

BatchUpdateException obejct がスローされた後もバッチ更新でコマンドを処理し続けるオプションに対応するために、Java 2 SDK、Standard Edition、バージョン 1.3 で可能な実装と戻り値が変更されました。

1.2 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象