SQLClientInfoException 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 is thrown when one or more client info properties could not be set on a Connection.

[Android.Runtime.Register("java/sql/SQLClientInfoException", DoNotGenerateAcw=true)]
public class SQLClientInfoException : Java.Sql.SQLException

[<Android.Runtime.Register("java/sql/SQLClientInfoException", DoNotGenerateAcw=true)>]
type SQLClientInfoException = class
    inherit SQLException

Inheritance: Exception

Throwable

Exception

SQLException
SQLClientInfoException

Attributes: RegisterAttribute

Remarks

The subclass of SQLException is thrown when one or more client info properties could not be set on a Connection. In addition to the information provided by SQLException, a SQLClientInfoException provides a list of client info properties that were not set.

Some databases do not allow multiple client info properties to be set atomically. For those databases, it is possible that some of the client info properties had been set even though the Connection.setClientInfo method threw an exception. An application can use the getFailedProperties method to retrieve a list of client info properties that were not set. The properties are identified by passing a Map<String,ClientInfoStatus> to the appropriate SQLClientInfoException constructor.

Added in 1.6.

Java documentation for java.sql.SQLClientInfoException.

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

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)
FailedProperties	Returns the list of client info properties that could not be set.
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)
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