ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) Méthode

Référence

Définition

Espace de noms:: Android.Content

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie qu’une synchronisation doit être demandée avec le compte, l’autorité et les extras spécifiés à la fréquence donnée.

[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

Paramètres

account: Account

le compte à spécifier dans la synchronisation

authority: String

fournisseur à spécifier dans la demande de synchronisation

extras: Bundle

paramètres supplémentaires à suivre avec la demande de synchronisation

pollFrequency: Int64

fréquence d’exécution de la synchronisation, en secondes. Sur le niveau d’API Android 24 et versions ultérieures, un intervalle minimal de 15 minutes est appliqué. Dans les versions précédentes, l’intervalle minimal est de 1 heure.

Attributs: RegisterAttribute

Exceptions

IllegalArgumentException

si un extra illégal a été défini ou si l’un des paramètres est null.

Remarques

Spécifie qu’une synchronisation doit être demandée avec le compte, l’autorité et les extras spécifiés à la fréquence donnée. S’il existe déjà une autre synchronisation périodique planifiée avec le compte, l’autorité et les extras, une nouvelle synchronisation périodique ne sera pas ajoutée, au lieu de cela, la fréquence de la précédente sera mise à jour.

Ces synchronisations périodiques respectent les paramètres « syncAutomatically » et « masterSyncAutomatically ». Bien que ces synchronisations soient planifiées à la fréquence spécifiée, cela peut prendre plus de temps pour qu’elle soit réellement démarrée si d’autres synchronisations sont à l’avance dans la file d’attente des opérations de synchronisation. Cela signifie que l’heure de début réelle peut dériver.

Les synchronisations périodiques ne sont pas autorisées à avoir l’un des #SYNC_EXTRAS_DO_NOT_RETRYéléments suivants : , , #SYNC_EXTRAS_FORCE#SYNC_EXTRAS_IGNORE_SETTINGS#SYNC_EXTRAS_IGNORE_BACKOFF#SYNC_EXTRAS_INITIALIZE, #SYNC_EXTRAS_EXPEDITED, défini #SYNC_EXTRAS_MANUAL#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB sur true. Si un élément est fourni, une IllegalArgumentException exception est levée.

Cette méthode nécessite que l’appelant conserve l’autorisation android.Manifest.permission#WRITE_SYNC_SETTINGS.

L’offre groupée d’une synchronisation périodique peut être interrogée par les applications disposant des autorisations appropriées à l’aide ContentResolver#getPeriodicSyncs(Account account, String provider)des autorisations. Par conséquent, aucune donnée sensible ne doit être transférée ici.

Documentation Java pour android.content.ContentResolver.addPeriodicSync(android.accounts.Account, java.lang.String, android.os.Bundle, long).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Partager via