BackupAgent.OnRestore メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
OnRestore(BackupDataInput, Int32, ParcelFileDescriptor) |
アプリケーションはバックアップから復元されるため、既存のデータをバックアップの内容に置き換える必要があります。 |
OnRestore(BackupDataInput, Int64, 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
この特定のデータ セットを android:versionCode
https://developer.android.com/guide/topics/manifest/manifest-element.html#vcode バックアップしたアプリケーションからの manifest 属性の値。 これにより、復元操作の実行を求められたときに、アプリケーションのエージェントが古いデータ バージョンを区別できるようになります。
- newState
- ParcelFileDescriptor
空のファイルを指す、開いている、読み取り/書き込みの ParcelFileDescriptor。 アプリケーションは、ストリームからデータを復元した後、ここで最終的なバックアップ状態を記録する data
必要があります。
完全バックアップ データセットを復元する場合、これは になります null
。
- 属性
例外
注釈
アプリケーションはバックアップから復元されるため、既存のデータをバックアップの内容に置き換える必要があります。 バックアップ データは、 パラメーターを data
使用して提供されます。 復元が完了すると、アプリケーションは最終的な状態の表現をファイル記述子に newState
書き込む必要があります。
アプリケーションは、古いデータを適切に消去し、このメソッドに提供されたデータに置き換える必要があります。 オペレーティング システムによって "ユーザー データのクリア" 操作は自動的に実行されません。 この例外は、復元試行が失敗した場合です。onRestore() が例外をスローした場合、OS はアプリケーションのデータが一貫性のない状態にある可能性があると想定し、続行する前にクリアします。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
適用対象
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
この特定のデータ セットを<バックアップしたアプリケーションの href="[TODO: @docRoot]guide/topics/manifest/manifest-element.html#vcode"<>android:versionCode
/>a manifest 属性の値。 これにより、復元操作の実行を求められたときに、アプリケーションのエージェントが古いデータ バージョンを区別できるようになります。
- newState
- ParcelFileDescriptor
空のファイルを指す、開いている、読み取り/書き込みの ParcelFileDescriptor。 アプリケーションは、コード データ</コード>> ストリームからデータを復元した後、ここで最終的なバックアップ状態を記録する<必要があります。 完全バックアップ データセットを復元する場合、これはコード>null</コード>になります<。
- 属性
注釈
長いアプリ バージョン #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)
コードを処理する の新しいバージョン。 既定の実装では、バージョン コードが int にキャストされ、 が呼び出されます #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)
。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。