DeadObjectException 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.
The object you are calling has died, because its hosting process no longer exists, or there has been a low-level binder error.
[Android.Runtime.Register("android/os/DeadObjectException", DoNotGenerateAcw=true)]
public class DeadObjectException : Android.OS.RemoteException[<Android.Runtime.Register("android/os/DeadObjectException", DoNotGenerateAcw=true)>]
type DeadObjectException = class
inherit RemoteException- Inheritance
- Derived
- Attributes
Remarks
The object you are calling has died, because its hosting process no longer exists, or there has been a low-level binder error.
If you get this exception from a system service, the error is usually nonrecoverable as the framework will restart. If you receive this error from an app, at a minimum, you should recover by resetting the connection. For instance, you should drop the binder, clean up associated state, and reset your connection to the service which threw this error. In order to simplify your error recovery paths, you may also want to "simply" restart your process. However, this may not be an option if the service you are talking to is unreliable or crashes frequently.
If this isn't from a service death and is instead from a low-level binder error, it will be from: <ul> <li> a one-way call queue filling up (too many one-way calls) <li> from the binder buffer being filled up, so that the transaction is rejected. </ul>
In these cases, more information about the error will be logged. However, there isn't a good way to differentiate this information at runtime. So, you should handle the error, as if the service died.
Java documentation for android.os.DeadObjectException.
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 |
|---|---|
| DeadObjectException() |
Initializes a new instance of the DeadObjectException class. |
| DeadObjectException(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
| DeadObjectException(String) |
Initializes a new instance of the DeadObjectException class. |
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 |
| Class |
Gets the runtime class of this throwable. (Inherited from Throwable) |
| 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 |
Provides JNI peer-member metadata for this type. |
| 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() | (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) |
| RethrowAsRuntimeException() |
Rethrow this as an unchecked runtime exception. (Inherited from RemoteException) |
| RethrowFromSystemServer() |
Rethrow this exception when we know it came from the system server. (Inherited from RemoteException) |
| 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 |