BackupAgent.OnBackup Methode

Definition

Namespace:: Android.App.Backup

Assembly:: Mono.Android.dll

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.

Die Anwendung wird aufgefordert, alle Daten zu schreiben, die seit der letzten Ausführung eines Sicherungsvorgangs geändert wurden.

[Android.Runtime.Register("onBackup", "(Landroid/os/ParcelFileDescriptor;Landroid/app/backup/BackupDataOutput;Landroid/os/ParcelFileDescriptor;)V", "GetOnBackup_Landroid_os_ParcelFileDescriptor_Landroid_app_backup_BackupDataOutput_Landroid_os_ParcelFileDescriptor_Handler")]
public abstract void OnBackup(Android.OS.ParcelFileDescriptor? oldState, Android.App.Backup.BackupDataOutput? data, Android.OS.ParcelFileDescriptor? newState);

[<Android.Runtime.Register("onBackup", "(Landroid/os/ParcelFileDescriptor;Landroid/app/backup/BackupDataOutput;Landroid/os/ParcelFileDescriptor;)V", "GetOnBackup_Landroid_os_ParcelFileDescriptor_Landroid_app_backup_BackupDataOutput_Landroid_os_ParcelFileDescriptor_Handler")>]
abstract member OnBackup : Android.OS.ParcelFileDescriptor * Android.App.Backup.BackupDataOutput * Android.OS.ParcelFileDescriptor -> unit

Parameter

oldState: ParcelFileDescriptor

Ein geöffneter, schreibgeschützter ParcelFileDescriptor, der auf den letzten Sicherungsstatus zeigt, 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 strukturierter Wrapper um einen geöffneten, lese-/schreibgeschützten Dateideskriptor, der auf das Sicherungsdatenziel zeigt. In der Regel verwendet die Anwendung Sicherungshilfsklassen, um in diese Datei zu schreiben.

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 die angeforderten Daten in den data Ausgabedatenstrom geschrieben wurden.

Attribute: RegisterAttribute

Ausnahmen

IOException

Hinweise

Die Anwendung wird aufgefordert, alle Daten zu schreiben, die seit der letzten Ausführung eines Sicherungsvorgangs geändert wurden. Die während des letzten Sicherungsdurchlaufs aufgezeichneten Zustandsdaten werden im oldState Dateideskriptor bereitgestellt. Ist oldState dies der Grund, ist nullkein alter Zustand verfügbar, und die Anwendung sollte eine vollständige Sicherung durchführen. In beiden Fällen sollte eine Darstellung des endgültigen Sicherungszustands nach diesem Durchlauf in die Datei geschrieben werden, auf die der Dateideskriptor verweist, der in newStateden Umbruch eingeschlossen ist.

Jede entität, die in den android.app.backup.BackupDataOutputdata Datenstrom geschrieben wurde, wird über den aktuellen Sicherungstransport übertragen und im Remotedatensatz unter dem schlüssel, der als Teil der Entität bereitgestellt wird, gespeichert. Durch das Schreiben einer Entität mit einer negativen Datengröße wird der Transport angewiesen, alle Entitäten zu löschen, die derzeit unter diesem Schlüssel aus dem Remotedatensatz vorhanden sind.

Java Dokumentation für android.app.backup.BackupAgent.onBackup(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: