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 through 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: - a oneway call queue filling up (too many oneway calls) - from the binder buffer being filled up, so that the transaction is rejected.
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
DeadObjectException() | |
DeadObjectException(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
DeadObjectException(String) |
Fields
is_generated | (Inherited from Throwable) |
Properties
Cause |
Returns the cause of this throwable or |
Class | (Inherited from Throwable) |
Handle |
The handle to the underlying Android instance. (Inherited from Throwable) |
JniIdentityHashCode | (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) |
PeerReference | (Inherited from Throwable) |
StackTrace | (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
AddSuppressed(Throwable) |
Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. (Inherited from Throwable) |
Dispose() | (Inherited from Throwable) |
Dispose(Boolean) | (Inherited from Throwable) |
FillInStackTrace() |
Fills in the execution stack trace. (Inherited from Throwable) |
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) |
SetStackTrace(StackTraceElement[]) |
Sets the stack trace elements that will be returned by
|
ToString() | (Inherited from Throwable) |
UnregisterFromRuntime() | (Inherited from Throwable) |
Explicit Interface Implementations
IJavaPeerable.Disposed() | (Inherited from Throwable) |
IJavaPeerable.DisposeUnlessReferenced() | (Inherited from Throwable) |
IJavaPeerable.Finalized() | (Inherited from Throwable) |
IJavaPeerable.JniManagedPeerState | (Inherited from Throwable) |
IJavaPeerable.SetJniIdentityHashCode(Int32) | (Inherited from Throwable) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) | (Inherited from Throwable) |
IJavaPeerable.SetPeerReference(JniObjectReference) | (Inherited from Throwable) |
Extension Methods
JavaCast<TResult>(IJavaObject) |
Performs an Android runtime-checked type conversion. |
JavaCast<TResult>(IJavaObject) | |
GetJniTypeName(IJavaPeerable) |
Gets the JNI name of the type of the instance |
JavaAs<TResult>(IJavaPeerable) |
Try to coerce |
TryJavaCast<TResult>(IJavaPeerable, TResult) |
Try to coerce |