BackupDataOutput Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece a interface estruturada por meio da qual uma BackupAgent confirma informações para o conjunto de dados de backup, por meio de seu 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- Herança
- Atributos
Comentários
Fornece a interface estruturada por meio da qual uma BackupAgent confirma informações para o conjunto de dados de backup, por meio de seu BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() método. Os dados gravados para backup são apresentados como um conjunto de "entidades", pares chave/valor em que cada "valor" de registro de dados binário é nomeado com uma cadeia de caracteres "chave".
Para confirmar um registro de dados no transporte de backup, o método do BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() agente grava primeiro um "cabeçalho de entidade" que fornece a cadeia de caracteres de chave para o registro e o tamanho total do valor binário para o registro. Depois que o cabeçalho tiver sido gravado, o agente gravará o próprio valor de entidade binária. O valor da entidade pode ser gravado em várias partes, se desejado, desde que a contagem total de bytes gravados corresponda ao #writeEntityHeader(String, int) writeEntityHeader()que foi fornecido.
Cadeias de caracteres de chave de entidade são consideradas exclusivas dentro do conjunto de dados de backup de um determinado aplicativo. Se um agente de backup gravar uma nova entidade em uma cadeia de caracteres de chave existente, seu valor substituirá qualquer valor anterior no armazenamento de dados remoto do transporte. Você pode remover um registro inteiramente do conjunto de dados remoto gravando um novo cabeçalho de entidade usando a chave do registro existente, mas fornecendo um parâmetro negativo dataSize . Quando você faz isso, o agente não precisa ligar #writeEntityData(byte[], int).
<h3>Exemplo</h3>
Aqui está um exemplo que ilustra uma maneira de fazer backup do valor de uma variável String chamada 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 documentação para android.app.backup.BackupDataOutput.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Construtores
| Nome | Description |
|---|---|
| BackupDataOutput(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Fornece a interface estruturada por meio da qual uma |
| JniPeerMembers |
Fornece a interface estruturada por meio da qual uma |
| PeerReference |
Fornece a interface estruturada por meio da qual uma |
| Quota |
Retorna a cota em bytes para a operação de backup atual do aplicativo. |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| TransportFlags |
Retorna sinalizadores com informações adicionais sobre o transporte de backup. |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Dispose() |
Fornece a interface estruturada por meio da qual uma |
| Dispose(Boolean) |
Fornece a interface estruturada por meio da qual uma |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| JavaFinalize() |
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| ToArray<T>() |
Fornece a interface estruturada por meio da qual uma |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Fornece a interface estruturada por meio da qual uma |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| WriteEntityData(Byte[], Int32) |
Escreva uma parte dos dados na entidade atual no transporte de backup. |
| WriteEntityDataAsync(Byte[], Int32) |
Fornece a interface estruturada por meio da qual uma |
| WriteEntityHeader(String, Int32) |
Marque o início de um registro no fluxo de dados de backup. |
| WriteEntityHeaderAsync(String, Int32) |
Fornece a interface estruturada por meio da qual uma |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
Fornece a interface estruturada por meio da qual uma |
| IJavaPeerable.DisposeUnlessReferenced() |
Fornece a interface estruturada por meio da qual uma |
| IJavaPeerable.Finalized() |
Fornece a interface estruturada por meio da qual uma |
| IJavaPeerable.JniManagedPeerState |
Fornece a interface estruturada por meio da qual uma |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Fornece a interface estruturada por meio da qual uma |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Fornece a interface estruturada por meio da qual uma |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Fornece a interface estruturada por meio da qual uma |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Fornece a interface estruturada por meio da qual uma |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |