BackupAgent.OnRestore 方法

定義

命名空間:: Android.App.Backup

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)	應用程式正在從備份還原，並應該用備份內容替換現有資料。
OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)	新版本 `#onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)` 的版本處理的是很長的應用程式版本碼。

OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)

應用程式正在從備份還原，並應該用備份內容替換現有資料。

[Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;ILandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_ILandroid_os_ParcelFileDescriptor_Handler")]
public abstract void OnRestore(Android.App.Backup.BackupDataInput? data, int appVersionCode, Android.OS.ParcelFileDescriptor? newState);

[<Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;ILandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_ILandroid_os_ParcelFileDescriptor_Handler")>]
abstract member OnRestore : Android.App.Backup.BackupDataInput * int * Android.OS.ParcelFileDescriptor -> unit

參數

data: BackupDataInput

一個結構化包裝器，包覆著一個開放且唯讀的檔案描述符，指向應用程式資料的完整快照。應用程式應使用此資料流中所代表的每一個實體。

appVersionCode: Int32

c android：versionCode</c> manifest 屬性的值<>，來自備份這組特定資料集的應用程式。這使得應用程式代理在被要求執行還原操作時，能夠區分可能的舊版本資料。

newState: ParcelFileDescriptor

一個開啟、可讀寫的 ParcelFileDescriptor 指向一個空檔案。應用程式應在從串流還原資料 data 後，在此記錄最終備份狀態。當完整備份資料集還原時，這會是 null。

屬性: RegisterAttribute

例外狀況

IOException

備註

應用程式正在從備份還原，並應該用備份內容替換現有資料。備用資料透過參數 data 提供。還原完成後，應用程式應將最終狀態的表示寫入 newState 檔案描述符。

應用程式負責正確地抹除舊資料，並以提供給此方法的資料來取代。作業系統不會自動執行「清除使用者資料」操作。例外情況是還原失敗：如果 onRestore（）拋出例外，作業系統會假設應用程式的資料可能處於不一致性狀態，並在繼續前清除該資料。

Java 文件 android.app.backup.BackupAgent.onRestore(android.app.backup.BackupDataInput, int, android.os.ParcelFileDescriptor)。

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

適用於

OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)

新版本 #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) 的版本處理的是很長的應用程式版本碼。

[Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;JLandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_JLandroid_os_ParcelFileDescriptor_Handler", ApiSince=28)]
public virtual void OnRestore(Android.App.Backup.BackupDataInput? data, long appVersionCode, Android.OS.ParcelFileDescriptor? newState);

[<Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;JLandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_JLandroid_os_ParcelFileDescriptor_Handler", ApiSince=28)>]
abstract member OnRestore : Android.App.Backup.BackupDataInput * int64 * Android.OS.ParcelFileDescriptor -> unit
override this.OnRestore : Android.App.Backup.BackupDataInput * int64 * Android.OS.ParcelFileDescriptor -> unit

參數

data: BackupDataInput

一個結構化包裝器，包覆著一個開放且唯讀的檔案描述符，指向應用程式資料的完整快照。應用程式應使用此資料流中所代表的每一個實體。

appVersionCode: Int64

a href=“[TODO： <]guide/topics/manifest/manifest-element.html#vcode”@docRoot>android:versionCode/a< manifest 屬性的值>，來自備份該資料集的應用程式。這使得應用程式代理在被要求執行還原操作時，能夠區分可能的舊版本資料。

newState: ParcelFileDescriptor

一個開啟、可讀寫的 ParcelFileDescriptor 指向一個空檔案。應用程式應該在從程式碼<資料>/程式碼<流還原資料>後，記錄最終備份狀態。當完整備份資料集還原時，這會是 <程式碼>空<碼/程式碼>。

屬性: RegisterAttribute

備註

新版本 #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) 的版本處理的是很長的應用程式版本碼。預設實作會將版本代碼鑄造為整數並呼叫 #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)。

Java 文件 android.app.backup.BackupAgent.onRestore(android.app.backup.BackupDataInput, long, android.os.ParcelFileDescriptor)。

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

適用於