語言

BackupAgent.OnBackup 方法

定義

應用程式被要求寫入自上次備份操作以來所變更的資料。

[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

參數

oldState
ParcelFileDescriptor

一個開放、唯讀的 ParcelFileDescriptor,指向應用程式最後提供的備份狀態。 可能是 null,此時未提供先前狀態,應用程式應執行完整備份。

data
BackupDataOutput

一個結構化包裝器,包裹著一個開啟的讀寫檔案描述符,指向備份資料目的地。 通常應用程式會使用備份輔助類別來寫入此檔案。

newState
ParcelFileDescriptor

一個開啟、可讀寫的 ParcelFileDescriptor 指向一個空檔案。 應用程式應在此記錄最終備份狀態,將請求的資料寫入 data 輸出串流。

屬性

例外狀況

備註

應用程式被要求寫入自上次備份操作以來所變更的資料。 最後一次備份時記錄的狀態資料會提供在檔案描述符中 oldState 。 若 oldState , null則沒有舊狀態可用,應用程式應執行完整備份。 在這兩種情況下,這次處理後的最終備份狀態表示都應該寫入由包裹在 newState的檔案描述符所指向的檔案。

每個寫入串流的 android.app.backup.BackupDataOutputdata 實體都會透過目前的備份傳輸傳輸,並以實體所提供的金鑰儲存在遠端資料集中。 寫入負資料大小的實體會指示傳輸系統刪除該鍵下目前存在的遠端資料集中的實體。

Java 文件 android.app.backup.BackupAgent.onBackup(android.os.ParcelFileDescriptor, android.app.backup.BackupDataOutput, android.os.ParcelFileDescriptor)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於