Binder 類別

定義

命名空間:: Android.OS

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

可可重帶物件的基底類別，是由 IBinder定義的輕量級遠端程序呼叫機制的核心部分。

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

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

繼承: Object

JavaObject

Object
Binder

屬性: RegisterAttribute

實作: IBinder IJavaObject IJavaPeerable IDisposable

備註

可可重帶物件的基底類別，是由 IBinder定義的輕量級遠端程序呼叫機制的核心部分。此類別是 IBinder 的實作，提供此類物件的標準本地實作。

大多數開發者不會直接實作這個類別，而是使用 aidl 工具來描述所需的介面，並由它產生相應的 Binder 子類別。不過，你可以直接從 Binder 衍生，實作自訂的 RPC 協定，或直接實例化一個原始的 Binder 物件，作為可跨程序共享的標記。

此類別只是基本的 IPC 原語;它不影響應用程式的生命週期，且僅在創建該程序持續運行時才有效。要正確使用此方法，必須在頂層應用程式元件（a android.app.Service、 android.app.Activity、或 android.content.ContentProvider）的上下文中進行，讓系統知道你的程序應該持續運行。

你必須記得在某些情況下你的流程可能會消失，因此在流程重新開始時，必須重新製作新的活頁夾並重新安裝。例如，如果你在中 android.app.Activity使用此程序，只要活動未啟動，程序隨時可能被終止;若活動後來被重新建立，則需建立新的活頁夾並交回正確位置;你需注意程序可能因其他原因（例如接收廣播）而啟動，且不需重新建立活動，因此會執行這是用來創建新 Binder 的程式碼。

Java 文件 android.os.Binder。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Binder()	預設建構子只是初始化物件。
Binder(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
Binder(String)	建構器用於建立原始的 Binder 物件（標記）以及描述符。

屬性

名稱	Description
CallingPid	回傳傳送你目前交易的程序的ID。
CallingUid	回傳分配給傳送當前交易的 Linux UID。
CallingUidOrThrow	回傳分配給發送當前交易的 Linux UID。
CallingUserHandle	回傳分配給傳送當前交易的程序的 UserHandle。
CallingWorkSourceUid	回傳呼叫者設定的工作來源。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
InterfaceDescriptor	預設實作會回傳一個空的介面名稱。
IsBinderAlive	待補充 `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	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
JniPeerMembers	提供此類型的 JNI 同儕成員元資料。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
AttachInterface(IInterface, String)	方便地將特定介面與 Binder 關聯的方法。
ClearCallingIdentity()	在目前執行緒中重設接收 IPC 的身份。
ClearCallingWorkSource()	清除了本討論串的工作來源。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
Dump(FileDescriptor, PrintWriter, String[])	將物件的狀態印入給定的串流中。
Dump(FileDescriptor, String[])	實作為呼叫更方便的版本 `#dump(FileDescriptor, PrintWriter, String[])`。
DumpAsync(FileDescriptor, String[])	類似 `#dump(FileDescriptor, String[])`，但確保目標執行非同步。
Equals(Object)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FlushPendingCommands()	將目前執行緒中待執行的 Binder 指令清除到核心驅動程式。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
JoinThreadPool()	將呼叫的執行緒加入 IPC 執行緒池。
LinkToDeath(IBinderDeathRecipient, Int32)	在地實施是一項 no-op。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnTransact(Int32, Parcel, Parcel, Int32)	預設實作是一個回傳 false 的存根。
PingBinder()	預設實作總是回傳 true——如果你看到這裡，物件是活的。
QueryLocalInterface(String)	如果描述符符合要求，請使用提供的 `#attachInterface attachInterface()` 資訊回傳 `IInterface` 相關描述符。
RestoreCallingIdentity(Int64)	將當前執行緒中接收的 IPC 身份恢復回先前由 `#clearCallingIdentity`返回的身份。
RestoreCallingWorkSource(Int64)	使用由 `#setCallingWorkSourceUid(int)` or `#clearCallingWorkSource()`返回的標記還原此執行緒的工作來源。
SetCallingWorkSourceUid(Int32)	為本討論串設定了工作來源。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
Transact(Int32, Parcel, Parcel, TransactionFlags)	預設實作會在 Transact 上倒帶包裹並呼叫。
UnlinkToDeath(IBinderDeathRecipient, Int32)	在地實施是一項 no-op。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	可可重帶物件的基底類別，是由 `IBinder`定義的輕量級遠端程序呼叫機制的核心部分。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於