BackupDataOutput 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供结构化接口,通过 BackupAgent 它 BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor)
onBackup() 的方法将信息提交到备份数据集。
[Android.Runtime.Register("android/app/backup/BackupDataOutput", DoNotGenerateAcw=true)]
public class BackupDataOutput : Java.Lang.Object
[<Android.Runtime.Register("android/app/backup/BackupDataOutput", DoNotGenerateAcw=true)>]
type BackupDataOutput = class
inherit Object
- 继承
- 特性
注解
提供结构化接口,通过 BackupAgent 它 BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() 的方法将信息提交到备份数据集。 为备份编写的数据显示为一组“实体”,其中每个二进制数据记录“value”都以字符串“key”命名。
若要将数据记录提交到备份传输,代理 BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() 的方法首先写入一个“实体标头”,该标头提供记录的键字符串和记录的二进制值的总大小。 写入标头后,代理将写入二进制实体值本身。 如果需要,可以按多个区块写入实体值,只要写入的总字节数与提供给 #writeEntityHeader(String, int) writeEntityHeader()的字节总数匹配。
实体密钥字符串被视为在给定应用程序的备份数据集中是唯一的。 如果备份代理在现有密钥字符串下写入新实体,则其值将替换传输远程数据存储中的任何以前的值。 可以通过使用现有记录的键编写新的实体标头来完全从远程数据集中删除记录,但提供负 dataSize 参数。 执行此操作时,代理不需要调用 #writeEntityData(byte[], int)。
<h3>示例</h3>
以下示例演示了一种备份名为 mStringToBackUp 的 String 变量值的方法:
static final String MY_STRING_KEY = "storedstring";
public void {@link BackupAgent#onBackup(ParcelFileDescriptor, BackupDataOutput, ParcelFileDescriptor) onBackup(ParcelFileDescriptor oldState, BackupDataOutput data, ParcelFileDescriptor newState)}
throws IOException {
...
byte[] stringBytes = mStringToBackUp.getBytes();
data.writeEntityHeader(MY_STRING_KEY, stringBytes.length);
data.writeEntityData(stringBytes, stringBytes.length);
...
}
Java文档android.app.backup.BackupDataOutput。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| BackupDataOutput(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| Quota |
返回应用程序的当前备份操作的配额(以字节为单位)。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| TransportFlags |
返回包含有关备份传输的其他信息的标志。 |
方法
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |