Sprache

IBackupHelper.PerformBackup Methode

Definition

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.

Java Dokumentation für android.app.backup.BackupHelper.performBackup(android.os.ParcelFileDescriptor, android.app.backup.BackupDataOutput, 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: