HandlerThread 類別

定義

命名空間:: Android.OS

組件:: Mono.Android.dll

重要

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

Thread A 具有 Looper。

[Android.Runtime.Register("android/os/HandlerThread", DoNotGenerateAcw=true)]
public class HandlerThread : Java.Lang.Thread

[<Android.Runtime.Register("android/os/HandlerThread", DoNotGenerateAcw=true)>]
type HandlerThread = class
    inherit Thread

繼承: Object

JavaObject

Object

Thread
HandlerThread

屬性: RegisterAttribute

備註

Thread A 具有 Looper。 Looper接著可以用來生成 Handlers。就像一般 Thread人一樣， #start() 還是必須叫。

<em>只有在必須使用 Handler API 且需要 Thread 處理非現有 Looper 執行緒的時才使用此類別，例如 Looper#getMainLooper()。</em> 否則，偏好 java.util.concurrent.Executor 使用 or java.util.concurrent.ExecutorService，或 Kotlin 協程。

請注意，許多在舊版 SDK 中需要 API Handler 的 API，現在提供了新的 java.util.concurrent.Executor 替代方案，接受如果有新的 API，建議還是用比較新的。

<h2>/h2 的替代方案HandlerThread<>

java.util.concurrent.Executor在穿線方面提供更多彈性。提交到 a java.util.concurrent.Executor 的工作可以設定在另一個執行緒上執行，無論是靜態或動態池中的多個執行緒之一，或是呼叫者的執行緒，視需求而定。

{連結

Java 文件 android.os.HandlerThread。

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

建構函式

名稱	Description
HandlerThread(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
HandlerThread(String, Int32)	建構一個 HandlerThread。
HandlerThread(String)	建構一個 HandlerThread。

欄位

名稱	Description
MaxPriority	執行緒能擁有的最大優先權。 (繼承來源 Thread)
MinPriority	這是執行緒可以擁有的最低優先權。 (繼承來源 Thread)
NormPriority	預設分配給執行緒的優先權。 (繼承來源 Thread)

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
ContextClassLoader	回傳本討論串的上下文 `ClassLoader` 。 -或- 為此執行緒設定上下文 ClassLoader。 (繼承來源 Thread)
Daemon	測試這個執行緒是否是守護程序執行緒。 (繼承來源 Thread)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
Id	回傳此執行緒的識別碼。 (繼承來源 Thread)
IsAlive	測試這個討論串是否還活著。 (繼承來源 Thread)
IsInterrupted	測試此串是否被中斷。 (繼承來源 Thread)
IsVirtual	如果這個執行緒是虛擬執行緒，則回傳 `true` 。 (繼承來源 Thread)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
JniPeerMembers	提供此類型的 JNI 同儕成員元資料。
Looper	此方法會回傳與此執行緒相關的迴圈器。
Name	回傳這個討論串的名稱。 -或- 將此線程名稱改為等於參數 `name`。 (繼承來源 Thread)
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Priority	返回本討論串的優先權。 (繼承來源 Thread)
ThreadGroup	回傳該執行緒所屬的執行緒群組。 (繼承來源 Thread)
ThreadId	回傳此執行緒的識別碼。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
UncaughtExceptionHandler	當此執行緒因未捕捉異常突然終止時，回傳所呼叫的處理器。 -或- 設定當該執行緒因未捕捉異常而突然終止時所呼叫的處理程序。 (繼承來源 Thread)

方法

名稱	Description
CheckAccess()	判斷目前執行的執行緒是否有權限修改此執行緒。 (繼承來源 Thread)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
CountStackFrames()	已淘汰. 拋出 `UnsupportedOperationException`。 (繼承來源 Thread)
Destroy()	已淘汰. 拋出 `UnsupportedOperationException`。 (繼承來源 Thread)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
Equals(Object)	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetStackTrace()	回傳一個堆疊追蹤元素陣列，代表該執行緒的堆疊傾印。 (繼承來源 Thread)
GetState()	返回本討論串的狀態。 (繼承來源 Thread)
Interrupt()	打斷這個討論串。 (繼承來源 Thread)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Join()	等著這個討論串死掉。 (繼承來源 Thread)
Join(Duration)	等待這串討論串終止，最多等待指定時間。 (繼承來源 Thread)
Join(Int64, Int32)	最多 `millis` 等幾毫秒加 `nanos` 奈秒，這串討論串就會死掉。 (繼承來源 Thread)
Join(Int64)	最多 `millis` 等一毫秒，這串討論串就會死掉。 (繼承來源 Thread)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnLooperPrepared()	回調方法，如果需要執行某些設定，可以在 Looper 循環前明確覆寫。
Quit()	退出處理線程的迴圈器。
QuitSafely()	安全退出處理線程的迴圈。
Resume()	已淘汰. 拋出 `UnsupportedOperationException`。 (繼承來源 Thread)
Run()	如果這個執行緒是用獨立 `Runnable` 的執行物件建構的，則會呼叫該 `Runnable` 物件的方法 `run` ;否則，這個方法什麼都不做，會回傳。 (繼承來源 Thread)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
Start()	會使此執行緒開始執行;Java 虛擬機會呼叫`run`此執行緒的方法。 (繼承來源 Thread)
Stop()	已淘汰. 拋出 `UnsupportedOperationException`。 (繼承來源 Thread)
Stop(Throwable)	已淘汰. 拋出 `UnsupportedOperationException`。 (繼承來源 Thread)
Suspend()	已淘汰. 拋出 `UnsupportedOperationException`。 (繼承來源 Thread)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
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()	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	`Thread` A 具有 `Looper`。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	`Thread` A 具有 `Looper`。 (繼承來源 Thread)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	`Thread` A 具有 `Looper`。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於