BackupDataOutput Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona la interfaz estructurada a través de la cual una BackupAgent información confirma al conjunto de datos de copia de seguridad a través de su BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor)
onBackup() método .
[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
- Herencia
- Atributos
Comentarios
Proporciona la interfaz estructurada a través de la cual una BackupAgent información confirma al conjunto de datos de copia de seguridad a través de su BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() método . Los datos escritos para la copia de seguridad se presentan como un conjunto de pares "entidades", clave-valor en los que cada registro de datos binarios "valor" se denomina con una cadena "clave".
Para confirmar un registro de datos en el transporte de copia de seguridad, el método del BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() agente escribe primero un "encabezado de entidad" que proporciona la cadena de clave para el registro y el tamaño total del valor binario para el registro. Después de escribir el encabezado, el agente escribe el propio valor de la entidad binaria. Si lo desea, el valor de la entidad se puede escribir en varios fragmentos, siempre y cuando el recuento total de bytes escritos coincida con lo que se proporcionó a #writeEntityHeader(String, int) writeEntityHeader().
Las cadenas de clave de entidad se consideran únicas dentro del conjunto de datos de copia de seguridad de una aplicación determinada. Si un agente de copia de seguridad escribe una nueva entidad en una cadena de clave existente, su valor reemplazará cualquier valor anterior en el almacén de datos remoto del transporte. Puede quitar un registro completamente del conjunto de datos remoto escribiendo un nuevo encabezado de entidad mediante la clave del registro existente, pero proporcionando un parámetro negativo dataSize . Al hacerlo, el agente no necesita llamar #writeEntityData(byte[], int)a .
<h3>Ejemplo</h3>
Este es un ejemplo que ilustra una manera de hacer una copia de seguridad del valor de una variable String denominada mStringToBackUp:
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 documentación para android.app.backup.BackupDataOutput.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| BackupDataOutput(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Proporciona la interfaz estructurada a través de la cual una |
| JniPeerMembers |
Proporciona la interfaz estructurada a través de la cual una |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| Quota |
Devuelve la cuota en bytes para la operación de copia de seguridad actual de la aplicación. |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| TransportFlags |
Devuelve marcas con información adicional sobre el transporte de copia de seguridad. |
Métodos
| Nombre | Description |
|---|---|
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Proporciona la interfaz estructurada a través de la cual una |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Proporciona la interfaz estructurada a través de la cual una |
| Equals(Object) |
Proporciona la interfaz estructurada a través de la cual una |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Proporciona la interfaz estructurada a través de la cual una |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| WriteEntityData(Byte[], Int32) |
Escriba un fragmento de datos en la entidad actual en el transporte de copia de seguridad. |
| WriteEntityDataAsync(Byte[], Int32) |
Proporciona la interfaz estructurada a través de la cual una |
| WriteEntityHeader(String, Int32) |
Marque el principio de un registro en el flujo de datos de copia de seguridad. |
| WriteEntityHeaderAsync(String, Int32) |
Proporciona la interfaz estructurada a través de la cual una |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Proporciona la interfaz estructurada a través de la cual una |
| IJavaPeerable.Finalized() |
Proporciona la interfaz estructurada a través de la cual una |
| IJavaPeerable.JniObjectReferenceControlBlock |
Proporciona la interfaz estructurada a través de la cual una |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Proporciona la interfaz estructurada a través de la cual una |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Proporciona la interfaz estructurada a través de la cual una |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Proporciona la interfaz estructurada a través de la cual una |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Proporciona la interfaz estructurada a través de la cual una |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |