AbstractThreadedSyncAdapter 類別

定義

命名空間:: Android.Content

組件:: Mono.Android.dll

重要

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

這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。

[Android.Runtime.Register("android/content/AbstractThreadedSyncAdapter", DoNotGenerateAcw=true)]
public abstract class AbstractThreadedSyncAdapter : Java.Lang.Object

[<Android.Runtime.Register("android/content/AbstractThreadedSyncAdapter", DoNotGenerateAcw=true)>]
type AbstractThreadedSyncAdapter = class
    inherit Object

繼承: Object

JavaObject

Object
AbstractThreadedSyncAdapter

屬性: RegisterAttribute

備註

這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。若同步操作正在進行中，接收同步請求時，錯誤會回傳給新請求，現有請求將被允許繼續。但如果沒有同步進行中，就會產生一個執行緒，並在 #onPerformSync 該執行緒中被呼叫。

框架可以隨時取消同步。例如，非使用者發起且持續超過 10 分鐘的同步將被視為逾時並取消。同樣地，框架會透過監控介面卡在一分鐘內的網路活動，來判斷其是否有進展。如果這個時段的網路流量接近零，同步就會被取消。你也可以透過或 ContentResolver#cancelSync(Account, String)ContentResolver#cancelSync(SyncRequest)。

同步是透過在同步執行緒上發出一個 Thread#interrupt() 來取消的。 <強力你的程式碼必須檢查>，或者你必須覆蓋其中一個#onPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult)Thread#interrupted()#onSyncCanceled(Thread)/ /strong#onSyncCanceled()（視你的轉接器是否支援多個帳號平行同步而定）。<> 如果你的轉接器不尊重框架發出的取消指令，你整個應用程式的流程就有可能被終止。

要成為同步介面卡，必須擴充此類別，提供抽象方法的實作，並撰寫一個服務，當以意圖呼叫時，返回服務#getSyncAdapterBinder()中的android.app.Service#onBind(android.content.Intent)android.content.SyncAdapter結果，並執行。此服務必須在其 AndroidManifest.xml 檔案中指定以下意圖過濾器與元資料標籤

&lt;intent-filter&gt;
                &lt;action android:name="android.content.SyncAdapter" /&gt;
              &lt;/intent-filter&gt;
              &lt;meta-data android:name="android.content.SyncAdapter"
                        android:resource="@xml/syncadapter" /&gt;

該 android:resource 屬性必須指向一個看起來像這樣的資源：

&lt;sync-adapter xmlns:android="http://schemas.android.com/apk/res/android"
               android:contentAuthority="authority"
               android:accountType="accountType"
               android:userVisible="true|false"
               android:supportsUploading="true|false"
               android:allowParallelSyncs="true|false"
               android:isAlwaysSyncable="true|false"
               android:syncAdapterSettingsAction="ACTION_OF_SETTINGS_ACTIVITY"
            /&gt;

<ul><li>與android:contentAuthorityandroid:accountType屬性表示此同步轉接器所服務的內容權威及帳號類型。 <LI>android:userVisible 預設為 true，並控制這個同步轉接器是否會出現在同步設定畫面。 <LI>android:supportsUploading 預設為 true，若為真，當該權威的內容提供者執行 ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver, boolean) sync ToNetwork 為 true 時，所有與該權威相關的同步器都會被請求僅上傳同步。 <LI>android:allowParallelSyncs 預設為 false，若為 true，則表示同步介面卡能同時處理多個帳號的同步。否則 SyncManager 會等到同步轉接器不再使用時才要求同步帳號資料。 <li>android:isAlwaysSyncable 預設為 false，若為 true，則告訴 SyncManager 將該同步卡的 isSyncable 狀態初始化為 1，針對每個新增的帳號。 <LI>android:syncAdapterSettingsAction 預設為 null，若提供此功能，則指定活動的意圖動作，可用來調整同步介面卡的同步設定。活動必須與同步轉接器同封裝。 </ul>

Java 文件 android.content.AbstractThreadedSyncAdapter。

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

建構函式

名稱	Description
AbstractThreadedSyncAdapter(Context, Boolean, Boolean)	建立 `AbstractThreadedSyncAdapter`。
AbstractThreadedSyncAdapter(Context, Boolean)	建立 `AbstractThreadedSyncAdapter`。
AbstractThreadedSyncAdapter(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
LogSyncDetails	已淘汰. 核心事件日誌標籤。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Context
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
JniPeerMembers	取得用於調用此 Java 節點成員的 JNI 元資料。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
SyncAdapterBinder
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
Equals(Object)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult)	為這個帳號進行同步。
OnSecurityException(Account, Bundle, String, SyncResult)	報告在呼叫 `#onPerformSync`前開啟內容提供者時出現安全例外。
OnSyncCanceled()	表示同步操作已被取消。
OnSyncCanceled(Thread)	表示同步操作已被取消。
OnUnsyncableAccount()	允許延遲同步，直到所有帳號都設定妥當。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
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()	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	這是一種抽象的 SyncAdapter 實作，會產生執行緒以呼叫同步操作。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於