SharedPreferencesBackupHelper 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
可搭配 android.app.backup.BackupAgentHelper
使用的協助程式類別,用來管理 的 android.content.SharedPreferences
備份。
[Android.Runtime.Register("android/app/backup/SharedPreferencesBackupHelper", DoNotGenerateAcw=true)]
public class SharedPreferencesBackupHelper : Android.App.Backup.FileBackupHelperBase, Android.App.Backup.IBackupHelper, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/app/backup/SharedPreferencesBackupHelper", DoNotGenerateAcw=true)>]
type SharedPreferencesBackupHelper = class
inherit FileBackupHelperBase
interface IBackupHelper
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 繼承
- 屬性
- 實作
備註
可搭配 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。
的 android.app.backup.SharedPreferencesBackupHelper
JAVA 檔。
此頁面的部分是根據所建立和共用的工作進行修改,並根據 2.5 屬性授權中所述的詞彙來使用。
建構函式
SharedPreferencesBackupHelper(Context, String[]) |
建構協助程式,以在指定的名稱下備份和還原 |
SharedPreferencesBackupHelper(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 標記法時使用的建構函式;由執行時間呼叫。 |
屬性
Class |
傳回這個 |
Handle |
基礎 Android 實例的控制碼。 (繼承來源 Object) |
JniIdentityHashCode |
可搭配 |
JniPeerMembers |
可搭配 |
PeerReference |
可搭配 |
ThresholdClass |
此 API 支援適用于 Android 的 Mono 基礎結構,並不適合直接從您的程式碼使用。 |
ThresholdType |
此 API 支援適用于 Android 的 Mono 基礎結構,並不適合直接從您的程式碼使用。 |
方法
Clone() |
建立並傳回這個 物件的複本。 (繼承來源 Object) |
Dispose() |
可搭配 |
Dispose(Boolean) |
可搭配 |
Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
JavaFinalize() |
當垃圾收集判斷物件不再參考物件時,垃圾收集行程會在物件上呼叫。 (繼承來源 Object) |
Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
PerformBackup(ParcelFileDescriptor, BackupDataOutput, ParcelFileDescriptor) |
備份已設定 |
RestoreEntity(BackupDataInputStream) |
將一個實體從還原資料流程還原至其適當的共用喜好設定檔案存放區。 |
SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
ToArray<T>() |
可搭配 |
ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
UnregisterFromRuntime() |
可搭配 |
Wait() |
讓目前的執行緒等到喚醒為止,通常是 em < notified/em > 或 < em > interrupted < /em > 。 >< (繼承來源 Object) |
Wait(Int64) |
讓目前的執行緒等到喚醒為止,通常是 em < notified/em > 或 < em > interrupted < /em > ,或直到經過一定數量的即時為止。 <> (繼承來源 Object) |
Wait(Int64, Int32) |
讓目前的執行緒等到喚醒為止,通常是 em < notified/em > 或 < em > interrupted < /em > ,或直到經過一定數量的即時為止。 <> (繼承來源 Object) |
WriteNewStateDescription(ParcelFileDescriptor) |
在還原作業之後呼叫 , BackupAgentHelper 以寫入對應至協助程式所處理資料的備份狀態檔案。 |
明確介面實作
IJavaPeerable.Disposed() |
可搭配 |
IJavaPeerable.DisposeUnlessReferenced() |
可搭配 |
IJavaPeerable.Finalized() |
可搭配 |
IJavaPeerable.JniManagedPeerState |
可搭配 |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
可搭配 |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
可搭配 |
IJavaPeerable.SetPeerReference(JniObjectReference) |
可搭配 |
擴充方法
PerformBackupAsync(IBackupHelper, ParcelFileDescriptor, BackupDataOutput, ParcelFileDescriptor) |
可搭配 |
JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
JavaCast<TResult>(IJavaObject) |
可搭配 |
GetJniTypeName(IJavaPeerable) |
可搭配 |