BackupAgent.OnRestore Methode

Definition

Namespace:
Android.App.Backup
Assembly:
Mono.Android.dll

Überlädt

Name Beschreibung
OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)

Die Anwendung wird aus der Sicherung wiederhergestellt und sollte vorhandene Daten durch den Inhalt der Sicherung ersetzen.
OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)

Neue Version dieses #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) Codes behandelt einen langen App-Versionscode.

OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)

Die Anwendung wird aus der Sicherung wiederhergestellt und sollte vorhandene Daten durch den Inhalt der Sicherung ersetzen.

[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

Parameter

data
BackupDataInput

Ein strukturierter Wrapper um einen geöffneten, schreibgeschützten Dateideskriptor, der auf eine vollständige Momentaufnahme der Anwendungsdaten zeigt. Die Anwendung sollte jede Entität verwenden, die in diesem Datenstrom dargestellt wird.

appVersionCode
Int32

Der Wert des android:versionCodehttps://developer.android.com/guide/topics/manifest/manifest-element.html#vcode Manifest-Attributs aus der Anwendung, die diesen bestimmten Datensatz gesichert hat. Dies ermöglicht es dem Agent einer Anwendung, zwischen allen möglichen älteren Datenversionen zu unterscheiden, wenn sie aufgefordert werden, den Wiederherstellungsvorgang auszuführen.

newState
ParcelFileDescriptor

Ein geöffneter, lese-/schreibgeschützter ParcelFileDescriptor, der auf eine leere Datei zeigt. Die Anwendung sollte den endgültigen Sicherungsstatus hier aufzeichnen, nachdem die Daten aus dem data Datenstrom wiederhergestellt wurden. Wenn ein vollständiges Backup-Dataset wiederhergestellt wird, lautet nulldies .

Attribute
RegisterAttribute

Ausnahmen

IOException

Hinweise

Die Anwendung wird aus der Sicherung wiederhergestellt und sollte vorhandene Daten durch den Inhalt der Sicherung ersetzen. Die Sicherungsdaten werden über den data Parameter bereitgestellt. Sobald die Wiederherstellung abgeschlossen ist, sollte die Anwendung eine Darstellung des endgültigen Zustands in den newState Dateideskriptor schreiben.

Die Anwendung ist dafür verantwortlich, die alten Daten ordnungsgemäß zu löschen und durch die an diese Methode bereitgestellten Daten zu ersetzen. Vom Betriebssystem werden keine "Löschen von Benutzerdaten" ausgeführt. Die Ausnahme ist im Falle eines fehlgeschlagenen Wiederherstellungsversuchs: Wenn onRestore() eine Ausnahme auslöst, geht das Betriebssystem davon aus, dass sich die Daten der Anwendung jetzt in einem inkohärenten Zustand befinden und vor dem Fortfahren löschen.

Java Dokumentation für android.app.backup.BackupAgent.onRestore(android.app.backup.BackupDataInput, int, android.os.ParcelFileDescriptor).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)

Neue Version dieses #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) Codes behandelt einen langen App-Versionscode.

[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

Parameter

data
BackupDataInput

Ein strukturierter Wrapper um einen geöffneten, schreibgeschützten Dateideskriptor, der auf eine vollständige Momentaufnahme der Anwendungsdaten zeigt. Die Anwendung sollte jede Entität verwenden, die in diesem Datenstrom dargestellt wird.

appVersionCode
Int64

Der Wert der <a href="[TODO: @docRoot]guide/topics/manifest/manifest-element.html#vcode">android:versionCode</a> manifest attribute, from the application that backed up this particular data set. Dies ermöglicht es dem Agent einer Anwendung, zwischen allen möglichen älteren Datenversionen zu unterscheiden, wenn sie aufgefordert werden, den Wiederherstellungsvorgang auszuführen.

newState
ParcelFileDescriptor

Ein geöffneter, lese-/schreibgeschützter ParcelFileDescriptor, der auf eine leere Datei zeigt. Die Anwendung sollte hier den endgültigen Sicherungsstatus aufzeichnen, nachdem sie ihre Daten aus dem <Codedaten><-/Codedatenstrom> wiederhergestellt haben. Wenn ein vollständiges Backup-Dataset wiederhergestellt wird, ist <dies code>null</code>.

Attribute
RegisterAttribute

Hinweise

Neue Version dieses #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) Codes behandelt einen langen App-Versionscode. Die Standardimplementierung wandelt den Versionscode in ein Int und Aufrufe #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)um.

Java Dokumentation für android.app.backup.BackupAgent.onRestore(android.app.backup.BackupDataInput, long, android.os.ParcelFileDescriptor).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: