SyncRequest.Builder 類別

定義

命名空間:: Android.Content

組件:: Mono.Android.dll

重要

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

建造者類別 SyncRequestfor a .

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

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

繼承: Object

JavaObject

Object
SyncRequest.Builder

屬性: RegisterAttribute

備註

建造者類別 SyncRequestfor a . 當你建立 SyncRequest 時，這個類別也會執行驗證。

Java 文件 android.content.SyncRequest.Builder。

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

建構函式

名稱	Description
SyncRequest.Builder()	建立一個同步請求的建構器。
SyncRequest.Builder(IntPtr, JniHandleOwnership)	初始化一個圍繞現有 Java 實例的受管理包裝器。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
JniPeerMembers	取得用於調用此 Java 節點成員的 JNI 元資料。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	讓 JNI 類別作為這個 Java 節點的派遣閾值。
ThresholdType	取得 JNI 類型作為該 Java 節點的派遣閾值。

方法

名稱	Description
Build()	對請求進行驗證，若驗證失敗則拋出執行時例外 `IllegalArgumentException` 。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
Equals(Object)	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetDisallowMetered(Boolean)	設定是否禁止此傳輸在計量網路上。若 `disallow` 為真，且在呼叫 SetIgnoreSettings（true）後，會拋出 IllegalArgumentException。
SetExpedited(Boolean)	加速同步會立即執行，並能搶佔其他非加速同步。不適用於週期同步，且會在 build（）中拋出 IllegalArgumentException。
SetExtras(Bundle)	開發者提供的額外內容會在同步時交還給他們。此套件會被複製到 build（）回傳的 SyncRequest 中。範例：String[] syncItems = {“dog”， “cat”， “frog”， “child”};SyncRequest.Builder 建構器 = new SyncRequest.Builder（） .setSyncAdapter（dummyAccount， dummyProvider） .syncOnce（）;for （String syncData ： syncItems） { Bundle extras = new Bundle（）; extras.setString（“data”， syncData）; builder.setExtras（extras）;ContentResolver.sync（builder.build（））;每個 sync（）請求都會產生唯一的同步。} 額外套件中僅能使用以下類型的值：整數、長布林浮點數、雙字串、帳號空若包中存在非此類型的資料，build（）會拋出執行時例外。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetIgnoreBackoff(Boolean)	方便設定ContentResolver.SYNC_EXTRAS_IGNORE_BACKOFF。忽略 back-off 會強制同步排程程序忽略因同步失敗而產生的任何 back-off ，並且會使介面卡可能設定的任何 SyncResult.delayUntil 值失效。連續失敗將無法尊崇這面旗幟。不適用於週期同步，且會在 build（）中拋出 IllegalArgumentException。
SetIgnoreSettings(Boolean)	方便設定ContentResolver.SYNC_EXTRAS_IGNORE_SETTINGS。不適用於週期同步，且會在 build（）中拋出 IllegalArgumentException。若被呼叫且設定，則拋出 IllegalArgumentException，DisallowMetered（boolean）已被設定。
SetManual(Boolean)	方便設定ContentResolver.SYNC_EXTRAS_MANUAL。不適用於週期同步，且會在 build（）中拋出 IllegalArgumentException。
SetNoRetry(Boolean)	方便設定ContentResolver.SYNC_EXTRAS_DO_NOT_RETRY。若一次性同步操作失敗，除非將此設定為 true，否則將以指數回退重新嘗試。不適用於週期同步，且會在 build（）中拋出 IllegalArgumentException。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
SetRequiresCharging(Boolean)	請指定同步是否需要手機插電。
SetScheduleAsExpeditedJob(Boolean)	方便設定ContentResolver.SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB。不要和ContentResolver.SYNC_EXTRAS_EXPEDITED混淆。不適用於定期同步、加速同步以及需要充電的同步——在 build（）中會拋出 IllegalArgumentException。參數 scheduleAsExpeditedJob 布林：是否要排程為加速工作。默認值 false。
SetSyncAdapter(Account, String)	請指定授權並說明此筆轉帳。
SyncOnce()	請求立即同步。範例：SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncOnce（）;
SyncPeriodic(Int64, Int64)	建立定期同步。這個建構器必須呼叫這個或 syncOnce（）來執行。同步依目標 android.provider 及額外套件內容來識別。在指定週期同步（呼叫此函式）後，無法重複使用同一個建構器來做一次性同步。如果你這麼做，將會拋出 IllegalArgumentException。具有正確權限的應用程式可以使用 ContentResolver.getPeriodicSyncs（Account，String）查詢週期同步的套件，因此不應在此傳輸敏感資料。範例用法。每5小時申請一次定期同步，並有20分鐘彈性時間。 SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncPeriodic（5 * HOUR_IN_SECS， 20 * MIN_IN_SECS）;在該小時的任何時間安排一次週期性同步。 SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncPeriodic（1 * HOUR_IN_SECS， 1 * HOUR_IN_SECS）;注意：週期同步不允許將 ContentResolver.SYNC_EXTRAS_DO_NOT_RETRY 、 ContentResolver.SYNC_EXTRAS_IGNORE_BACKOFF、ContentResolver.SYNC_EXTRAS_IGNORE_SETTINGS、ContentResolver.SYNC_EXTRAS_INITIALIZE、ContentResolver.SYNC_EXTRAS_FORCE、ContentResolver.SYNC_EXTRAS_EXPEDITED、ContentResolver.SYNC_EXTRAS_MANUAL、ContentResolver.SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB 中的任何一個設定為 true。如果提供任何例外，則會拋出 IllegalArgumentException。
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()	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
IJavaPeerable.Finalized()	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	建造者類別 `SyncRequest`for a . (繼承來源 JavaObject)

擴充方法

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

適用於