BackupAgent.OnBackup 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
應用程式被要求寫入自上次備份操作以來所變更的資料。
[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 實體都會透過目前的備份傳輸傳輸,並以實體所提供的金鑰儲存在遠端資料集中。 寫入負資料大小的實體會指示傳輸系統刪除該鍵下目前存在的遠端資料集中的實體。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。