BackupAgent.OnRestore Méthode
Définition
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.
Surcharges
| Nom | Description |
|---|---|
| OnRestore(BackupDataInput, Int32, ParcelFileDescriptor) |
L’application est restaurée à partir de la sauvegarde et doit remplacer toutes les données existantes par le contenu de la sauvegarde. |
| OnRestore(BackupDataInput, Int64, ParcelFileDescriptor) |
Nouvelle version de |
OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)
L’application est restaurée à partir de la sauvegarde et doit remplacer toutes les données existantes par le contenu de la sauvegarde.
[Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;ILandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_ILandroid_os_ParcelFileDescriptor_Handler")]
public abstract void OnRestore(Android.App.Backup.BackupDataInput? data, int appVersionCode, Android.OS.ParcelFileDescriptor? newState);
[<Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;ILandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_ILandroid_os_ParcelFileDescriptor_Handler")>]
abstract member OnRestore : Android.App.Backup.BackupDataInput * int * Android.OS.ParcelFileDescriptor -> unit
Paramètres
- data
- BackupDataInput
Wrapper structuré autour d’un descripteur de fichier ouvert en lecture seule pointant vers un instantané complet des données de l’application. L’application doit consommer chaque entité représentée dans ce flux de données.
- appVersionCode
- Int32
Valeur de l’attribut <manifeste c>android :versionCode</c> , à partir de l’application qui a sauvegardé ce jeu de données particulier. Cela permet à l’agent d’une application de faire la distinction entre les versions de données antérieures possibles lorsqu’il est demandé d’effectuer l’opération de restauration.
- newState
- ParcelFileDescriptor
Un élément ParcelFileDescriptor ouvert et en lecture/écriture pointant vers un fichier vide. L’application doit enregistrer l’état de sauvegarde final ici après avoir restauré ses données à partir du data flux. Lorsqu’un jeu de données de sauvegarde complète est restauré, il s’agit nullde .
- Attributs
Exceptions
Remarques
L’application est restaurée à partir de la sauvegarde et doit remplacer toutes les données existantes par le contenu de la sauvegarde. Les données de sauvegarde sont fournies via le data paramètre. Une fois la restauration terminée, l’application doit écrire une représentation de l’état final dans le newState descripteur de fichier.
L’application est chargée d’effacer correctement ses anciennes données et de les remplacer par les données fournies à cette méthode. Aucune opération « effacer les données utilisateur » ne sera effectuée automatiquement par le système d’exploitation. L’exception à ceci se trouve dans le cas d’une tentative de restauration ayant échoué : si onRestore() lève une exception, le système d’exploitation part du principe que les données de l’application peuvent désormais être dans un état incohérent et l’effaceront avant de continuer.
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.
S’applique à
OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)
Nouvelle version de #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) ce qui gère un code de version d’application long.
[Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;JLandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_JLandroid_os_ParcelFileDescriptor_Handler", ApiSince=28)]
public virtual void OnRestore(Android.App.Backup.BackupDataInput? data, long appVersionCode, Android.OS.ParcelFileDescriptor? newState);
[<Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;JLandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_JLandroid_os_ParcelFileDescriptor_Handler", ApiSince=28)>]
abstract member OnRestore : Android.App.Backup.BackupDataInput * int64 * Android.OS.ParcelFileDescriptor -> unit
override this.OnRestore : Android.App.Backup.BackupDataInput * int64 * Android.OS.ParcelFileDescriptor -> unit
Paramètres
- data
- BackupDataInput
Wrapper structuré autour d’un descripteur de fichier ouvert en lecture seule pointant vers un instantané complet des données de l’application. L’application doit consommer chaque entité représentée dans ce flux de données.
- appVersionCode
- Int64
Valeur de l’attribut <href="[TODO : @docRoot]guide/topics/manifest/manifest-element.html#vcode">android:versionCode</a> manifest, à partir de l’application qui a sauvegardé ce jeu de données particulier. Cela permet à l’agent d’une application de faire la distinction entre les versions de données antérieures possibles lorsqu’il est demandé d’effectuer l’opération de restauration.
- newState
- ParcelFileDescriptor
Un élément ParcelFileDescriptor ouvert et en lecture/écriture pointant vers un fichier vide. L’application doit enregistrer l’état de sauvegarde final ici après avoir restauré ses données à partir du <flux de données>/de code de code<>. Lorsqu’un jeu de données de sauvegarde complète est restauré, il s’agit <de code>null</code>.
- Attributs
Remarques
Nouvelle version de #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) ce qui gère un code de version d’application long. L’implémentation par défaut convertit le code de version en un int et appelle #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor).
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.