IBackupHelper.PerformBackup Methode
Definition
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.
Ermitteln Sie basierend auf oldState, welche Anwendungsinhalte gesichert werden müssen, schreiben Sie sie in datanewState , und füllen Sie den vollständigen Zustand aus, wie sie jetzt vorhanden ist.
[Android.Runtime.Register("performBackup", "(Landroid/os/ParcelFileDescriptor;Landroid/app/backup/BackupDataOutput;Landroid/os/ParcelFileDescriptor;)V", "GetPerformBackup_Landroid_os_ParcelFileDescriptor_Landroid_app_backup_BackupDataOutput_Landroid_os_ParcelFileDescriptor_Handler:Android.App.Backup.IBackupHelperInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void PerformBackup(Android.OS.ParcelFileDescriptor? oldState, Android.App.Backup.BackupDataOutput? data, Android.OS.ParcelFileDescriptor? newState);
[<Android.Runtime.Register("performBackup", "(Landroid/os/ParcelFileDescriptor;Landroid/app/backup/BackupDataOutput;Landroid/os/ParcelFileDescriptor;)V", "GetPerformBackup_Landroid_os_ParcelFileDescriptor_Landroid_app_backup_BackupDataOutput_Landroid_os_ParcelFileDescriptor_Handler:Android.App.Backup.IBackupHelperInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PerformBackup : Android.OS.ParcelFileDescriptor * Android.App.Backup.BackupDataOutput * Android.OS.ParcelFileDescriptor -> unit
Parameter
- oldState
- ParcelFileDescriptor
Ein geöffneter, schreibgeschützter android.os.ParcelFileDescriptor Zeiger auf den letzten Sicherungsstatus, der von der Anwendung bereitgestellt wird. Kann sein null, in diesem Fall wird kein vorheriger Zustand bereitgestellt, und die Anwendung sollte eine vollständige Sicherung durchführen.
- data
- BackupDataOutput
Ein geöffneter Lese-/Schreibzugriff BackupDataOutput , der auf das Sicherungsdatenziel zeigt.
In der Regel verwendet die Anwendung Sicherungshilfsklassen, um in diese Datei zu schreiben.
- newState
- ParcelFileDescriptor
Ein geöffneter Lese-/Schreibzugriff android.os.ParcelFileDescriptor , der auf eine leere Datei zeigt. Die Anwendung sollte hier den endgültigen Sicherungsstatus aufzeichnen, nachdem die angeforderten Daten in den data Ausgabedatenstrom geschrieben wurden.
- Attribute
Hinweise
Ermitteln Sie basierend auf oldState, welche Anwendungsinhalte gesichert werden müssen, schreiben Sie sie in datanewState , und füllen Sie den vollständigen Zustand aus, wie sie jetzt vorhanden ist.
Die Implementierung dieser Methode ähnelt der Implementierung BackupAgent#onBackup(ParcelFileDescriptor, BackupDataOutput, ParcelFileDescriptor) onBackup() von — die Methodenparameter sind identisch. Wenn diese Methode aufgerufen wird, verweist der oldState Deskriptor auf den Anfang der Zustandsdaten, die während des vorherigen Sicherungsvorgangs dieses Helfers geschrieben wurden, und der newState Deskriptor verweist auf den Dateispeicherort, an dem der Hilfsdienst nach dem Ausführen des Sicherungsvorgangs seinen neuen Zustand schreiben soll.
<strong>Note:</strong> The helper should not close or seek either the oldState or the newState file descriptors. Es ist wichtig, dass beim Lesen des gespeicherten Zustands des Helfers aus der oldState Datei über das gespeicherte Element hinaus keine zusätzlichen Inhalte verbraucht werden, die von diesem Hilfsprogramm gespeichert wurden. Wenn alte Zustandsdaten gelesen werden, sogar versehentlich, wird es für zusätzliche Helfer unmöglich, die nach diesem Zustand aufgerufen werden können, um ihren vorherigen Zustand ordnungsgemäß zu rekonstruieren.
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.