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 |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniPeerMembers |
Fornece a interface estruturada por meio da qual uma |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| 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() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| 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>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| 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() |
Notifica o runtime de interoperabilidade de que esse par gerenciado foi descartado. (Herdado de Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Libera esse par Java, a menos que seja mantido por outra referência gerenciada. (Herdado de Object) |
| IJavaPeerable.Finalized() |
Notifica o runtime de interoperabilidade de que esse par gerenciado foi finalizado. (Herdado de Object) |
| IJavaPeerable.JniManagedPeerState |
Obtém o estado que descreve a relação entre esse par gerenciado e sua referência de JNI. (Herdado de Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Define o código de hash de identidade de interoperabilidade para esse par Java. (Herdado de Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Define o estado de par gerenciado e JNI para esse par Java. (Herdado de Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Define a referência de objeto JNI usada por esse par gerenciado. (Herdado de Object) |
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 |