BatchUpdateException Class

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

Name	Description
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

Name	Description
is_generated	Indicates whether this throwable was generated by the binding. (Inherited from Throwable)

Properties

Name	Description
Cause	Returns the cause of this throwable or `null` if the cause is nonexistent or unknown. (Inherited from Throwable)
Class	Gets the runtime class of this throwable. (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	Gets the identity hash code assigned to this Java peer by the interop runtime. (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	Gets the JNI object reference for this Java peer. (Inherited from Throwable)
SQLState	Retrieves the SQLState for this `SQLException` object. (Inherited from SQLException)
StackTrace	Gets a string representation of the stack trace for this throwable. (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

Name	Description
AddSuppressed(Throwable)	Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. (Inherited from Throwable)
Dispose()	Releases the resources held by this Java peer. (Inherited from Throwable)
Dispose(Boolean)	Releases the resources held by this Java peer. (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()	Converts this value to a string. (Inherited from Throwable)
UnregisterFromRuntime()	Unregisters this Java peer from the interop runtime. (Inherited from Throwable)

Explicit Interface Implementations

Name	Description
IIterable.Iterator()	(Inherited from SQLException)
IJavaPeerable.Disposed()	Notifies the interop runtime that this managed peer has been disposed. (Inherited from Throwable)
IJavaPeerable.DisposeUnlessReferenced()	Releases this Java peer unless it is retained by another managed reference. (Inherited from Throwable)
IJavaPeerable.Finalized()	Notifies the interop runtime that this managed peer has been finalized. (Inherited from Throwable)
IJavaPeerable.JniManagedPeerState	Gets the state that describes the relationship between this managed peer and its JNI reference. (Inherited from Throwable)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Sets the interop identity hash code for this Java peer. (Inherited from Throwable)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Sets the managed and JNI peer state for this Java peer. (Inherited from Throwable)
IJavaPeerable.SetPeerReference(JniObjectReference)	Sets the JNI object reference used by this managed peer. (Inherited from Throwable)

Extension Methods

Name	Description
GetJniTypeName(IJavaPeerable)	Gets the JNI name of the type of the instance `self`.
JavaAs<TResult>(IJavaPeerable)	Try to coerce `self` to type `TResult`, checking that the coercion is valid on the Java side.
JavaCast<TResult>(IJavaObject)	Performs an Android runtime-checked type conversion.
JavaCast<TResult>(IJavaObject)
ToEnumerable(IIterable)
ToEnumerable<T>(IIterable)
TryJavaCast<TResult>(IJavaPeerable, TResult)	Try to coerce `self` to type `TResult`, checking that the coercion is valid on the Java side.

Applies to