BatchUpdateException Class

Reference

Definition

Namespace:: Java.Sql

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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: Exception

Throwable

Exception

SQLException
BatchUpdateException

Attributes: RegisterAttribute

Implements: IJavaObject IJavaPeerable ISerializable IDisposable

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[], Throwable)	Constructs a `BatchUpdateException` object initialized with a given `cause` and `updateCounts`.
BatchUpdateException(Int32[])	Constructs a `BatchUpdateException` object initialized with a given `updateCounts`.
BatchUpdateException(IntPtr, JniHandleOwnership)	A constructor used when creating managed representations of JNI objects; called by the runtime.
BatchUpdateException(String, Int32[], Throwable)	Constructs a `BatchUpdateException` object initialized with a given `reason`, `cause` and `updateCounts`.
BatchUpdateException(String, Int32[])	Constructs a `BatchUpdateException` object initialized with a given `reason` 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, Int32[])	Constructs a `BatchUpdateException` object initialized with a given `reason`, `SQLState`, `vendorCode` and `updateCounts`.
BatchUpdateException(String, String, Int32[], Throwable)	Constructs a `BatchUpdateException` object initialized with a given `reason`, `SQLState`,`cause`, and `updateCounts`.
BatchUpdateException(String, String, Int32[])	Constructs a `BatchUpdateException` object initialized with a given `reason`, `SQLState` 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

Share via