SharedPreferencesBackupHelper 類別

定義

[Android.Runtime.Register("android/app/backup/SharedPreferencesBackupHelper", DoNotGenerateAcw=true)]
public class SharedPreferencesBackupHelper : Android.App.Backup.FileBackupHelperBase, Android.App.Backup.IBackupHelper, IDisposable

[<Android.Runtime.Register("android/app/backup/SharedPreferencesBackupHelper", DoNotGenerateAcw=true)>]
type SharedPreferencesBackupHelper = class
    inherit FileBackupHelperBase
    interface IBackupHelper
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

FileBackupHelperBase

SharedPreferencesBackupHelper

屬性

RegisterAttribute

實作

IBackupHelper IJavaObject IJavaPeerable IDisposable

備註

一個可與 搭配使用 android.app.backup.BackupAgentHelper 以管理 備份的 android.content.SharedPreferences輔助類別。 每當執行備份時，會備份自上次備份操作以來所有已變更的命名共享偏好設定。

要使用此類別，應用程式的備份代理類別應擴充 android.app.backup.BackupAgentHelper。 接著，依照代理 BackupAgent#onCreate() 程式的方法，應分配並安裝此類別的實例作為 BackupAgentHelper 框架中的備份/還原處理器。 例如，支援兩組 android.content.SharedPreferences 資料的應用程式備份與還原的代理程式可能如下：

import android.app.backup.BackupAgentHelper;
            import android.app.backup.SharedPreferencesBackupHelper;

            public class MyBackupAgent extends BackupAgentHelper {
                // The names of the SharedPreferences groups that the application maintains.  These
                // are the same strings that are passed to {@link Context#getSharedPreferences(String, int)}.
                static final String PREFS_DISPLAY = "displayprefs";
                static final String PREFS_SCORES = "highscores";

                // An arbitrary string used within the BackupAgentHelper implementation to
                // identify the SharedPreferenceBackupHelper's data.
                static final String MY_PREFS_BACKUP_KEY = "myprefs";

                // Allocate a helper and install it.
                public void onCreate() {
                    SharedPreferencesBackupHelper helper =
                            new SharedPreferencesBackupHelper(this, PREFS_DISPLAY, PREFS_SCORES);
                    addHelper(MY_PREFS_BACKUP_KEY, helper);
                }
            }

無需進一步實作;機制會 BackupAgentHelper 自動派 BackupAgent#onBackup(android.os.ParcelFileDescriptor, BackupDataOutput, android.os.ParcelFileDescriptor) BackupAgent.onBackup() 遣並 BackupAgent#onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) BackupAgent.onRestore() 回調給 SharedPreferencesBackupHelper。

Java 文件 android.app.backup.SharedPreferencesBackupHelper。

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