ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) Methode

Referenz

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt an, dass eine Synchronisierung mit dem angegebenen Konto, der Autorität und den Extras in der angegebenen Häufigkeit angefordert werden soll.

[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

Parameter

account: Account

das Konto, das in der Synchronisierung angegeben werden soll

authority: String

der Anbieter, der in der Synchronisierungsanforderung angegeben werden soll

extras: Bundle

zusätzliche Parameter, die zusammen mit der Synchronisierungsanforderung verwendet werden sollen

pollFrequency: Int64

Wie häufig die Synchronisierung durchgeführt werden soll, in Sekunden. Auf Android-API-Ebene 24 und höher wird ein Mindestintervall von 15 Minuten erzwungen. In früheren Versionen beträgt das Mindestintervall 1 Stunde.

Attribute: RegisterAttribute

Ausnahmen

IllegalArgumentException

wenn ein unzulässiges Extra festgelegt wurde oder wenn eines der Parameter null ist.

Hinweise

Gibt an, dass eine Synchronisierung mit dem angegebenen Konto, der Autorität und den Extras in der angegebenen Häufigkeit angefordert werden soll. Wenn bereits eine andere regelmäßige Synchronisierung mit dem Konto, der Autorität und den Extras geplant ist, wird keine neue regelmäßige Synchronisierung hinzugefügt, sondern die Häufigkeit der vorherigen wird aktualisiert.

Diese regelmäßigen Synchronisierungen berücksichtigen die Einstellungen "syncAutomatically" und "masterSyncAutomatically". Obwohl diese Synchronisierung mit der angegebenen Häufigkeit geplant ist, kann es länger dauern, bis sie tatsächlich gestartet wird, wenn andere Synchronisierungen in der Synchronisierungsvorgangswarteschlange voraus sind. Dies bedeutet, dass die tatsächliche Startzeit abdriften kann.

Regelmäßige Synchronisierungen dürfen keines von #SYNC_EXTRAS_DO_NOT_RETRY, , #SYNC_EXTRAS_IGNORE_BACKOFF, #SYNC_EXTRAS_IGNORE_SETTINGS, , #SYNC_EXTRAS_INITIALIZE, #SYNC_EXTRAS_FORCE, #SYNC_EXTRAS_EXPEDITED, #SYNC_EXTRAS_MANUALauf #SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB "true" festgelegt haben. Wenn eine angegeben wird, wird eine IllegalArgumentException ausgelöst.

Für diese Methode muss der Aufrufer die Berechtigung android.Manifest.permission#WRITE_SYNC_SETTINGSenthalten.

Das Bündel für eine regelmäßige Synchronisierung kann von Anwendungen mit den richtigen Berechtigungen ContentResolver#getPeriodicSyncs(Account account, String provider)abgefragt werden, sodass hier keine vertraulichen Daten übertragen werden sollten.

Java-Dokumentation für android.content.ContentResolver.addPeriodicSync(android.accounts.Account, java.lang.String, android.os.Bundle, long).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Freigeben über