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 A 數位大於或等於零 -- 表示命令已成功處理,而且是更新計數,提供受命令執行 <LI>>A 值SUCCESS_NO_INFO
影響之資料庫中的數據列數目 -- 表示命令已成功處理,但受影響的數據列數目未知
如果批次更新中的其中一個命令無法正常執行,這個方法會 BatchUpdateException
擲回 ,而 JDBC 驅動程式可能會或可能不會繼續處理批次中的其餘命令。 不過,驅動程式的行為必須與特定的 DBMS 一致,一律會繼續處理命令,或永遠不會繼續處理命令。 如果驅動程式在失敗後繼續處理,則 方法 BatchUpdateException.getUpdateCounts
傳回的陣列會包含批次中命令的數目,而且至少其中一個元素如下:
<LI>的值 EXECUTE_FAILED
-- 表示命令無法順利執行,且只有在驅動程式在命令失敗 /OL 之後 <繼續處理命令時才會發生>
Java 2 SDK Standard Edition 1.3 版中已修改可能的實作和傳回值,以配合在擲回 obejct 之後 BatchUpdateException
繼續在批次更新中繼續執行命令的選項。
已在1.2中新增。
的 java.sql.Statement.executeBatch()
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。