Binder Klasse

Definition

Namespace:: Android.OS

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Basisklasse für ein remotable-Objekt, der Kernteil eines einfachen Remoteprozeduraufrufmechanismus, der durch definiert wird IBinder.

[Android.Runtime.Register("android/os/Binder", DoNotGenerateAcw=true)]
public class Binder : Java.Lang.Object, Android.OS.IBinder, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/os/Binder", DoNotGenerateAcw=true)>]
type Binder = class
    inherit Object
    interface IBinder
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Vererbung: Object

Object
Binder

Attribute: RegisterAttribute

Implementiert: IBinder IJavaObject IJavaPeerable IDisposable

Hinweise

Basisklasse für ein remotable-Objekt, der Kernteil eines einfachen Remoteprozeduraufrufmechanismus, der durch definiert wird IBinder. Diese Klasse ist eine Implementierung von IBinder, die eine standardmäßige lokale Implementierung eines solchen Objekts bereitstellt.

Die meisten Entwickler implementieren diese Klasse nicht direkt, sondern verwenden das Aidl-Tool , um die gewünschte Schnittstelle zu beschreiben, indem sie die entsprechende Binder-Unterklasse generiert. Sie können jedoch direkt von Binder ableiten, um Ihr eigenes benutzerdefiniertes RPC-Protokoll zu implementieren oder einfach ein unformatiertes Binder-Objekt direkt zu instanziieren, um es als Token zu verwenden, das über Prozesse hinweg freigegeben werden kann.

Diese Klasse ist nur ein einfacher IPC-Grundtyp; es hat keine Auswirkungen auf den Lebenszyklus einer Anwendung und ist nur gültig, solange der Prozess, der sie erstellt hat, weiterhin ausgeführt wird. Um dies ordnungsgemäß zu verwenden, müssen Sie dies im Kontext einer Anwendung auf oberster Ebene (a android.app.Service, android.app.Activityoder android.content.ContentProvider) tun, die das System informiert, dass Ihr Prozess weiterhin ausgeführt werden soll.

Sie müssen die Situationen berücksichtigen, in denen Ihr Prozess weggehen könnte, und daher erfordern, dass Sie später einen neuen Binder neu erstellen und ihn erneut anfügen, wenn der Prozess erneut gestartet wird. Wenn Sie dies z. B. innerhalb eines android.app.ActivityVorgangs verwenden, kann der Prozess Ihrer Aktivität jedes Mal getötet werden, wenn die Aktivität nicht gestartet wird. Wenn die Aktivität später neu erstellt wird, müssen Sie einen neuen Sammelordner erstellen und es wieder an den richtigen Ort übergeben. Sie müssen sich bewusst sein, dass Ihr Prozess aus einem anderen Grund (z. B. zum Empfangen einer Übertragung) gestartet werden kann, die keine erneute Erstellung der Aktivität beinhaltet und somit ausgeführt wird. der Code zum Erstellen eines neuen Binders.

Java Dokumentation für android.os.Binder.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
Binder()	Der Standardkonstruktor initialisiert einfach das Objekt.
Binder(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.
Binder(String)	Konstruktor zum Erstellen eines unformatierten Binder-Objekts (Token) zusammen mit einem Deskriptor.

Eigenschaften

Name	Beschreibung
CallingPid	Gibt die ID des Prozesses zurück, der Ihnen die aktuelle Transaktion gesendet hat, die verarbeitet wird.
CallingUid	Geben Sie die Linux-UID zurück, die dem Prozess zugewiesen ist, der Ihnen die aktuelle Transaktion gesendet hat, die verarbeitet wird.
CallingUidOrThrow	Gibt die Linux-UID zurück, die dem Prozess zugewiesen ist, der die aktuell verarbeitete Transaktion gesendet hat.
CallingUserHandle	Gibt das userHandle zurück, das dem Prozess zugewiesen ist, der Ihnen die aktuelle Transaktion gesendet hat, die verarbeitet wird.
CallingWorkSourceUid	Gibt die vom Aufrufer festgelegte Arbeitsquelle zurück.
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
InterfaceDescriptor	Die Standardimplementierung gibt einen leeren Schnittstellennamen zurück.
IsBinderAlive	So wird's hinzugefügt `Note that if you're calling on a local binder, this always returns true because your process is alive if you're calling it.`
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniPeerMembers	Stellt JNI-Peer-Membermetadaten für diesen Typ bereit.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
AttachInterface(IInterface, String)	Convenience-Methode zum Zuordnen einer bestimmten Schnittstelle zum Binder.
ClearCallingIdentity()	Setzen Sie die Identität des eingehenden IPC im aktuellen Thread zurück.
ClearCallingWorkSource()	Löscht die Arbeitsquelle für diesen Thread.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dump(FileDescriptor, PrintWriter, String[])	Drucken Sie den Zustand des Objekts in den angegebenen Datenstrom.
Dump(FileDescriptor, String[])	Implementiert, um die komfortablere Version `#dump(FileDescriptor, PrintWriter, String[])`aufzurufen.
DumpAsync(FileDescriptor, String[])	Gefällt `#dump(FileDescriptor, String[])`mir , stellt jedoch sicher, dass das Ziel asynchron ausgeführt wird.
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
FlushPendingCommands()	Leeren Sie alle Ordnerbefehle, die im aktuellen Thread an den Kerneltreiber ausstehen.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
JoinThreadPool()	Fügen Sie den aufrufenden Thread zum IPC-Threadpool hinzu.
LinkToDeath(IBinderDeathRecipient, Int32)	Die lokale Implementierung ist eine no-op.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
OnTransact(Int32, Parcel, Parcel, Int32)	Die Standardimplementierung ist ein Stub, der "false" zurückgibt.
PingBinder()	Die Standardimplementierung gibt immer true zurück – wenn Sie hier sind, ist das Objekt lebendig.
QueryLocalInterface(String)	Verwenden Sie informationen, die angegeben werden, um `#attachInterface attachInterface()` den zugeordneten `IInterface` Wert zurückzugeben, wenn sie mit dem angeforderten Deskriptor übereinstimmt.
RestoreCallingIdentity(Int64)	Stellen Sie die Identität des eingehenden IPC im aktuellen Thread wieder auf eine zuvor zurückgegebene `#clearCallingIdentity`Identität zurück.
RestoreCallingWorkSource(Int64)	Stellt die Arbeitsquelle für diesen Thread mithilfe eines von `#setCallingWorkSourceUid(int)` oder .`#clearCallingWorkSource()`
SetCallingWorkSourceUid(Int32)	Legt die Arbeitsquelle für diesen Thread fest.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
Transact(Int32, Parcel, Parcel, TransactionFlags)	Bei der Standardimplementierung werden die Pakete und Anrufe anTransact zurückspulen.
UnlinkToDeath(IBinderDeathRecipient, Int32)	Die lokale Implementierung ist eine no-op.
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Benachrichtigt die Interoplaufzeit, dass dieser verwaltete Peer verworfen wurde. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Gibt diesen Java Peer frei, es sei denn, er wird von einem anderen verwalteten Verweis beibehalten. (Geerbt von Object)
IJavaPeerable.Finalized()	Benachrichtigt die Interoplaufzeit, dass dieser verwaltete Peer abgeschlossen wurde. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Ruft den Zustand ab, der die Beziehung zwischen diesem verwalteten Peer und seinem JNI-Verweis beschreibt. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Legt den Interop-Identitätshashcode für diesen Java Peer fest. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Legt den verwalteten und JNI-Peerstatus für diesen Java Peer fest. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Legt den JNI-Objektverweis fest, der von diesem verwalteten Peer verwendet wird. (Geerbt von Object)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Basisklasse für ein remotable-Objekt, der Kernteil eines einfachen Remoteprozeduraufrufmechanismus, der durch definiert wird `IBinder`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: