BackupManager.RequestRestore(RestoreObserver) Méthode

[Android.Runtime.Register("requestRestore", "(Landroid/app/backup/RestoreObserver;)I", "GetRequestRestore_Landroid_app_backup_RestoreObserver_Handler")]
public virtual int RequestRestore(Android.App.Backup.RestoreObserver? observer);

[<Android.Runtime.Register("requestRestore", "(Landroid/app/backup/RestoreObserver;)I", "GetRequestRestore_Landroid_app_backup_RestoreObserver_Handler")>]
abstract member RequestRestore : Android.App.Backup.RestoreObserver -> int
override this.RequestRestore : Android.App.Backup.RestoreObserver -> int

Paramètres

Retours

Zéro sur le succès ; non zéro sur l’erreur.

Attributs

RegisterAttribute

Remarques

Ce membre est déconseillé. Les applications ne doivent pas demander une opération de restauration à l’aide de cette méthode. Dans Android P et versions ultérieures, cette méthode est une no-op.

<p>Restaurer l’application appelante à partir de la sauvegarde. Les données sont restaurées à partir du jeu de données de sauvegarde actuel si l’application y a stocké des données, ou à partir du jeu de données utilisé lors de la dernière opération de configuration complète de l’appareil si le jeu de données de sauvegarde actuel n’a pas de données correspondantes. Si aucune donnée de sauvegarde n’existe pour cette application dans l’une ou l’autre source, une valeur différente de zéro est retournée.

<p>Si cette méthode retourne zéro (ce qui signifie réussite), le système d’exploitation tente de récupérer un jeu de données sauvegardé à partir du transport distant, instanciez l’agent de sauvegarde de l’application et transmettez le jeu de données à la méthode de android.app.backup.BackupAgent#onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) onRestore() l’agent.

<p class="attention">Contrairement aux autres opérations de restauration, cette méthode n’arrête pas l’application après la restauration. L’application continue à s’exécuter pour recevoir les RestoreObserver rappels sur l’argument observer . Les sauvegardes complètes utilisent une android.app.Application Application classe de base tandis que les sauvegardes clé-valeur utilisent la sous-classe d’application déclarée dans la balise AndroidManifest.xml <application> .

Java documentation pour android.app.backup.BackupManager.requestRestore(android.app.backup.RestoreObserver).

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