DOMException Class
Definition
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.
DOM operations only raise exceptions in "exceptional" circumstances, i.
[Android.Runtime.Register("org/w3c/dom/DOMException", DoNotGenerateAcw=true)]
public class DOMException : Java.Lang.RuntimeException
[<Android.Runtime.Register("org/w3c/dom/DOMException", DoNotGenerateAcw=true)>]
type DOMException = class
inherit RuntimeException
- Inheritance
- Attributes
Remarks
DOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impossible to perform (either for logical reasons, because data is lost, or because the implementation has become unstable). In general, DOM methods return specific error values in ordinary processing situations, such as out-of-bound errors when using NodeList.
Implementations should raise other exceptions under other circumstances. For example, implementations should raise an implementation-dependent exception if a null argument is passed when null was not expected.
Some languages and object systems do not support the concept of exceptions. For such systems, error conditions may be indicated using native error reporting mechanisms. For some bindings, for example, methods may return error codes similar to those listed in the corresponding method descriptions.
See also the Document Object Model (DOM) Level 3 Core Specification.
Java documentation for org.w3c.dom.DOMException.
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 |
|---|---|
| DOMException(Int16, String) |
Initializes a new instance of DOMException with the specified error code and message. |
| DOMException(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
Fields
| Name | Description |
|---|---|
| DomstringSizeErr |
If the specified range of text does not fit into a
|
| HierarchyRequestErr |
If any |
| IndexSizeErr |
If index or size is negative, or greater than the allowed value. |
| InuseAttributeErr |
If an attempt is made to add an attribute that is already in use elsewhere. |
| InvalidAccessErr |
If a parameter or an operation is not supported by the underlying object. |
| InvalidCharacterErr |
If an invalid or illegal character is specified, such as in an XML name. |
| InvalidModificationErr |
If an attempt is made to modify the type of the underlying object. |
| InvalidStateErr |
If an attempt is made to use an object that is not, or is no longer, usable. |
| is_generated |
Indicates whether this throwable was generated by the binding. (Inherited from Throwable) |
| NamespaceErr |
If an attempt is made to create or change an object in a way which is incorrect with regard to namespaces. |
| NoDataAllowedErr |
If data is specified for a |
| NoModificationAllowedErr |
If an attempt is made to modify an object where modifications are not allowed. |
| NotFoundErr |
If an attempt is made to reference a |
| NotSupportedErr |
If the implementation does not support the requested type of object or operation. |
| SyntaxErr |
If an invalid or illegal string is specified. |
| TypeMismatchErr |
If the type of an object is incompatible with the expected type of the parameter associated to the object. |
| ValidationErr |
If a call to a method such as |
| WrongDocumentErr |
If a |
Properties
| Name | Description |
|---|---|
| Cause |
Returns the cause of this throwable or |
| Class |
Gets the runtime class of this throwable. (Inherited from Throwable) |
| Code |
Gets the code identifying this DOM exception type. |
| Handle |
The handle to the underlying Android instance. (Inherited from Throwable) |
| JavaStackTrace | (Inherited from JavaException) |
| JniIdentityHashCode |
Gets the identity hash code assigned to this Java peer by the interop runtime. (Inherited from Throwable) |
| JniManagedPeerState | (Inherited from JavaException) |
| JniPeerMembers |
Gets the JNI metadata used to invoke members of this Java peer. |
| LocalizedMessage |
Creates a localized description of this throwable. (Inherited from Throwable) |
| Message |
Returns the detail message string of this throwable. (Inherited from Throwable) |
| PeerReference |
Gets the JNI object reference for this Java peer. (Inherited from Throwable) |
| 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) |
| Construct(JniObjectReference, JniObjectReferenceOptions) | (Inherited from JavaException) |
| 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) |
| DisposeUnlessReferenced() | (Inherited from JavaException) |
| Equals(Object) | (Inherited from JavaException) |
| FillInStackTrace() |
Fills in the execution stack trace. (Inherited from Throwable) |
| GetHashCode() |
Returns a hash code value for the object. (Inherited from JavaException) |
| GetStackTrace() |
Provides programmatic access to the stack trace information printed by
|
| GetSuppressed() |
Returns an array containing all of the exceptions that were
suppressed, typically by the |
| InitCause(Throwable) |
Initializes the cause of this throwable to the specified value. (Inherited from Throwable) |
| 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) |
| SetJavaStackTrace(JniObjectReference) | (Inherited from JavaException) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) | (Inherited from JavaException) |
| SetStackTrace(StackTraceElement[]) |
Sets the stack trace elements that will be returned by
|
| 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 |
|---|---|
| IJavaPeerable.Disposed() | (Inherited from JavaException) |
| IJavaPeerable.Finalized() | (Inherited from JavaException) |
| IJavaPeerable.JniObjectReferenceControlBlock | (Inherited from JavaException) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) | (Inherited from JavaException) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) | (Inherited from JavaException) |
| IJavaPeerable.SetPeerReference(JniObjectReference) | (Inherited from JavaException) |
Extension Methods
| Name | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Gets the JNI name of the type of the instance |
| JavaAs<TResult>(IJavaPeerable) |
Try to coerce |
| JavaCast<TResult>(IJavaObject) |
Performs an Android runtime-checked type conversion. |
| JavaCast<TResult>(IJavaObject) | |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Try to coerce |