ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された頻度で、指定されたアカウント、機関、および追加のアカウントで同期を要求する必要があることを指定します。
[Android.Runtime.Register("addPeriodicSync", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;J)V", "")]
public static void AddPeriodicSync (Android.Accounts.Account? account, string? authority, Android.OS.Bundle? extras, long pollFrequency);
[<Android.Runtime.Register("addPeriodicSync", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;J)V", "")>]
static member AddPeriodicSync : Android.Accounts.Account * string * Android.OS.Bundle * int64 -> unit
パラメーター
- account
- Account
同期で指定するアカウント
- authority
- String
同期要求で指定するプロバイダー
- extras
- Bundle
同期要求と共に行く追加のパラメーター
- pollFrequency
- Int64
同期を実行する頻度 (秒単位)。 Android API レベル 24 以上では、15 分以上の間隔が適用されます。 以前のバージョンでは、最小間隔は 1 時間です。
- 属性
例外
無効なエクストラが設定された場合、またはいずれかのパラメーターが null の場合。
注釈
指定された頻度で、指定されたアカウント、機関、および追加のアカウントで同期を要求する必要があることを指定します。 アカウント、機関、追加でスケジュールされた別の定期的な同期が既にある場合、新しい定期的な同期は追加されません。代わりに、前の同期の頻度が更新されます。
これらの定期的な同期では、"syncAutomatically" と "masterSyncAutomatically" の設定が適用されます。 これらの同期は指定された頻度でスケジュールされますが、他の同期が同期操作キューの前にある場合、実際に開始されるまでに時間がかかる場合があります。 これは、実際の開始時刻がずれる可能性があることを意味します。
定期的な同期では、,, , , , #SYNC_EXTRAS_EXPEDITED
#SYNC_EXTRAS_INITIALIZE
#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB
#SYNC_EXTRAS_MANUAL
#SYNC_EXTRAS_FORCE
, を true に設定することはできません。#SYNC_EXTRAS_DO_NOT_RETRY
#SYNC_EXTRAS_IGNORE_BACKOFF
#SYNC_EXTRAS_IGNORE_SETTINGS
いずれかが指定された場合は、an IllegalArgumentException
がスローされます。
このメソッドでは、呼び出し元がアクセス許可 android.Manifest.permission#WRITE_SYNC_SETTINGS
を保持する必要があります。
定期的な同期のバンドルは、適切なアクセス許可を持つアプリケーションがクエリを実行 ContentResolver#getPeriodicSyncs(Account account, String provider)
できるため、ここで機密データを転送する必要はありません。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。