IStatement.ExecuteBatch 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將一批指令提交到資料庫執行，若所有指令都成功執行，則回傳一組更新次數陣列。
[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[]傳回
一個包含批次中每個指令一個元素的更新計數陣列。 陣列的元素依指令加入批次的順序排列。
- 屬性
例外狀況
如果存取資料庫時發生錯誤。
備註
將一批指令提交到資料庫執行，若所有指令都成功執行，則回傳一組更新次數陣列。
int回傳的陣列元素會依序對應批次中的指令，而指令的順序則依加入批次的順序排列。 方法 executeBatch 回傳的陣列元素可能如下之一： <OL><LI>大於或等於零的數字表示指令已成功處理，為更新計數，表示受指令執行 <影響的資料庫列數;LI>值為 SUCCESS_NO_INFO —— 表示指令已成功處理，但受影響的列數未知
若批次更新中的某個指令未能正確執行，此方法會拋出一個 BatchUpdateException，JDBC 驅動程式是否會繼續處理批次中剩餘的指令。 然而，驅動程式的行為必須與特定資料庫管理系統一致，要麼持續處理指令，要麼永遠不繼續處理指令。 若驅動程式在失敗後繼續處理，方法 BatchUpdateException.getUpdateCounts 回傳的陣列將包含與批次指令數量相同的元素，且至少有一個元素會為以下內容：
<LI>值為 EXECUTE_FAILED -- 表示指令未能成功執行，且僅在驅動程式在指令失敗 <後繼續處理指令時才會發生 /OL>
在 Java 2 SDK 標準版 1.3 版本中，可能的實作與回傳值已修改，以配合在丟出 obejct 後BatchUpdateException，繼續在批次更新中執行指令的選項。
在 1.2 版本中加入。
Java 文件 java.sql.Statement.executeBatch()。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。