BackupAgent.OnRestore メソッド

定義

名前空間:: Android.App.Backup

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Name	説明
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> マニフェスト属性の値。これにより、復元操作の実行を求められた場合に、アプリケーションのエージェントが古いデータバージョンを区別できるようになります。

newState: ParcelFileDescriptor

空のファイルを指す、開いている、読み取り/書き込みの ParcelFileDescriptor。アプリケーションは、 data ストリームからデータを復元した後、ここに最終的なバックアップ状態を記録する必要があります。完全バックアップデータセットを復元すると、これが nullされます。

属性: RegisterAttribute

例外

IOException

注釈

アプリケーションはバックアップから復元中であり、既存のデータをバックアップの内容に置き換える必要があります。バックアップデータは、 data パラメーターを使用して提供されます。復元が完了すると、アプリケーションは最終的な状態の表現を newState ファイル記述子に書き込む必要があります。

アプリケーションは、古いデータを適切に消去し、このメソッドに指定されたデータに置き換える必要があります。 "ユーザーデータのクリア" 操作はオペレーティングシステムによって自動的に実行されません。これに対する例外は、復元試行が失敗した場合です。onRestore() が例外をスローした場合、OS はアプリケーションのデータが一貫性のない状態にある可能性があることを前提とし、続行する前にクリアします。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

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: @docRoot]guide/topics/manifest/manifest-element.html#vcode">android:versionCode</a> マニフェスト属性の値。これにより、復元操作の実行を求められた場合に、アプリケーションのエージェントが古いデータバージョンを区別できるようになります。

newState: ParcelFileDescriptor

空のファイルを指す、開いている、読み取り/書き込みの ParcelFileDescriptor。アプリケーションは、 <code>data</code> ストリームからデータを復元した後、ここで最終的なバックアップ状態を記録する必要があります。完全バックアップデータセットを復元すると、 <code>null</code>になります。

属性: RegisterAttribute

注釈

長いアプリバージョンコードを処理する #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) の新しいバージョン。既定の実装では、バージョンコードが int にキャストされ、 #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)が呼び出されます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象