BatchUpdateException Class

Definition

The subclass of SQLException thrown when an error occurs during a batch update operation.

[Android.Runtime.Register("java/sql/BatchUpdateException", DoNotGenerateAcw=true)]
public class BatchUpdateException : Java.Sql.SQLException, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("java/sql/BatchUpdateException", DoNotGenerateAcw=true)>]
type BatchUpdateException = class
    inherit SQLException
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Inheritance
BatchUpdateException
Attributes
Implements

Remarks

The subclass of SQLException thrown when an error occurs during a batch update operation. In addition to the information provided by SQLException, a BatchUpdateException provides the update counts for all commands that were executed successfully during the batch update, that is, all commands that were executed before the error occurred. The order of elements in an array of update counts corresponds to the order in which commands were added to the batch.

After a command in a batch update fails to execute properly and a BatchUpdateException is thrown, the driver may or may not continue to process the remaining commands in the batch. If the driver continues processing after a failure, the array returned by the method BatchUpdateException.getUpdateCounts will have an element for every command in the batch rather than only elements for the commands that executed successfully before the error. In the case where the driver continues processing commands, the array element for any command that failed is Statement.EXECUTE_FAILED.

Added in 1.2.

Java documentation for java.sql.BatchUpdateException.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

BatchUpdateException()

Constructs a BatchUpdateException object.

BatchUpdateException(Int32[])

Constructs a BatchUpdateException object initialized with a given updateCounts.

BatchUpdateException(Int32[], Throwable)

Constructs a BatchUpdateException object initialized with a given cause and updateCounts.

BatchUpdateException(IntPtr, JniHandleOwnership)

A constructor used when creating managed representations of JNI objects; called by the runtime.

BatchUpdateException(String, Int32[])

Constructs a BatchUpdateException object initialized with a given reason and updateCounts.

BatchUpdateException(String, Int32[], Throwable)

Constructs a BatchUpdateException object initialized with a given reason, cause and updateCounts.

BatchUpdateException(String, String, Int32, Int32[])

Constructs a BatchUpdateException object initialized with a given reason, SQLState, vendorCode and updateCounts.

BatchUpdateException(String, String, Int32, Int32[], Throwable)

Constructs a BatchUpdateException object initialized with a given reason, SQLState, vendorCodecause and updateCounts.

BatchUpdateException(String, String, Int32[])

Constructs a BatchUpdateException object initialized with a given reason, SQLState and updateCounts.

BatchUpdateException(String, String, Int32[], Throwable)

Constructs a BatchUpdateException object initialized with a given reason, SQLState,cause, and updateCounts.

BatchUpdateException(Throwable)

Constructs a BatchUpdateException object initialized with a given cause.

Fields

is_generated (Inherited from Throwable)

Properties

Cause

Returns the cause of this throwable or null if the cause is nonexistent or unknown.

(Inherited from Throwable)
Class (Inherited from Throwable)
ErrorCode

Retrieves the vendor-specific exception code for this SQLException object.

(Inherited from SQLException)
Handle

The handle to the underlying Android instance.

(Inherited from Throwable)
JniIdentityHashCode (Inherited from Throwable)
JniPeerMembers
LocalizedMessage

Creates a localized description of this throwable.

(Inherited from Throwable)
Message

Returns the detail message string of this throwable.

(Inherited from Throwable)
NextException

Retrieves the exception chained to this SQLException object by setNextException(SQLException ex). -or- Adds an SQLException object to the end of the chain.

(Inherited from SQLException)
PeerReference (Inherited from Throwable)
SQLState

Retrieves the SQLState for this SQLException object.

(Inherited from SQLException)
StackTrace (Inherited from Throwable)
ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

Methods

AddSuppressed(Throwable)

Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.

(Inherited from Throwable)
Dispose() (Inherited from Throwable)
Dispose(Boolean) (Inherited from Throwable)
FillInStackTrace()

Fills in the execution stack trace.

(Inherited from Throwable)
GetStackTrace()

Provides programmatic access to the stack trace information printed by #printStackTrace().

(Inherited from Throwable)
GetSuppressed()

Returns an array containing all of the exceptions that were suppressed, typically by the try-with-resources statement, in order to deliver this exception.

(Inherited from Throwable)
GetUpdateCounts()

Retrieves the update count for each update statement in the batch update that executed successfully before this exception occurred.

InitCause(Throwable)

Initializes the cause of this throwable to the specified value.

(Inherited from Throwable)
Iterator()

Returns an iterator over the chained SQLExceptions.

(Inherited from SQLException)
PrintStackTrace()

Prints this throwable and its backtrace to the standard error stream.

(Inherited from Throwable)
PrintStackTrace(PrintStream)

Prints this throwable and its backtrace to the specified print stream.

(Inherited from Throwable)
PrintStackTrace(PrintWriter)

Prints this throwable and its backtrace to the specified print writer.

(Inherited from Throwable)
SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Throwable)
SetStackTrace(StackTraceElement[])

Sets the stack trace elements that will be returned by #getStackTrace() and printed by #printStackTrace() and related methods.

(Inherited from Throwable)
ToString() (Inherited from Throwable)
UnregisterFromRuntime() (Inherited from Throwable)

Explicit Interface Implementations

IIterable.Iterator() (Inherited from SQLException)
IJavaPeerable.Disposed() (Inherited from Throwable)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Throwable)
IJavaPeerable.Finalized() (Inherited from Throwable)
IJavaPeerable.JniManagedPeerState (Inherited from Throwable)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Throwable)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Throwable)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Throwable)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)
ToEnumerable(IIterable)
ToEnumerable<T>(IIterable)

Applies to