SQLException 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.

An exception that provides information on a database access error or other errors.

[Android.Runtime.Register("java/sql/SQLException", DoNotGenerateAcw=true)]
public class SQLException : Java.Lang.Exception, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IIterable

[<Android.Runtime.Register("java/sql/SQLException", DoNotGenerateAcw=true)>]
type SQLException = class
    inherit Exception
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IIterable

Inheritance: Exception

Throwable

Exception
SQLException

Derived: Java.Sql.BatchUpdateException

Java.Sql.SQLClientInfoException

Java.Sql.SQLNonTransientException

Java.Sql.SQLRecoverableException

Java.Sql.SQLTransientException

More…

Attributes: RegisterAttribute

Implements: IJavaObject IJavaPeerable ISerializable IIterable IDisposable

Remarks

An exception that provides information on a database access error or other errors.

Each SQLException provides several kinds of information: <UL> <LI> a string describing the error. This is used as the Java Exception message, available via the method getMesasge. <LI> a "SQLstate" string, which follows either the XOPEN SQLstate conventions or the SQL:2003 conventions. The values of the SQLState string are described in the appropriate spec. The DatabaseMetaData method getSQLStateType can be used to discover whether the driver returns the XOPEN type or the SQL:2003 type. <LI> an integer error code that is specific to each vendor. Normally this will be the actual error code returned by the underlying database. <LI> a chain to a next Exception. This can be used to provide additional error information. <LI> the causal relationship, if any for this SQLException. </UL>

Java documentation for java.sql.SQLException.

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
SQLException()	Constructs a `SQLException` object.
SQLException(IntPtr, JniHandleOwnership)	A constructor used when creating managed representations of JNI objects; called by the runtime.
SQLException(String, String, Int32, Throwable)	Constructs a `SQLException` object with a given `reason`, `SQLState`, `vendorCode` and `cause`.
SQLException(String, String, Int32)	Constructs a `SQLException` object with a given `reason`, `SQLState` and `vendorCode`.
SQLException(String, String, Throwable)	Constructs a `SQLException` object with a given `reason`, `SQLState` and `cause`.
SQLException(String, String)	Constructs a `SQLException` object with a given `reason` and `SQLState`.
SQLException(String, Throwable)	Constructs a `SQLException` object with a given `reason` and `cause`.
SQLException(String)	Constructs a `SQLException` object with a given `reason`.
SQLException(Throwable)	Constructs a `SQLException` object 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.
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.
PeerReference	Gets the JNI object reference for this Java peer. (Inherited from Throwable)
SQLState	Retrieves the SQLState for this `SQLException` object.
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)
InitCause(Throwable)	Initializes the cause of this throwable to the specified value. (Inherited from Throwable)
Iterator()	Returns an iterator over the chained SQLExceptions.
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()
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