BackupAgent.OnRestore Método

Definição

Namespace:: Android.App.Backup

Assembly:: Mono.Android.dll

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.

Sobrecargas

Nome	Description
OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)	O aplicativo está sendo restaurado do backup e deve substituir todos os dados existentes pelo conteúdo do backup.
OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)	A nova versão trata de um código de `#onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor)` versão de aplicativo longo.

OnRestore(BackupDataInput, Int32, ParcelFileDescriptor)

O aplicativo está sendo restaurado do backup e deve substituir todos os dados existentes pelo conteúdo do backup.

[Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;ILandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_ILandroid_os_ParcelFileDescriptor_Handler")]
public abstract void OnRestore(Android.App.Backup.BackupDataInput? data, int appVersionCode, Android.OS.ParcelFileDescriptor? newState);

[<Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;ILandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_ILandroid_os_ParcelFileDescriptor_Handler")>]
abstract member OnRestore : Android.App.Backup.BackupDataInput * int * Android.OS.ParcelFileDescriptor -> unit

Parâmetros

data: BackupDataInput

Um wrapper estruturado em torno de um descritor de arquivo aberto somente leitura apontando para um instantâneo completo dos dados do aplicativo. O aplicativo deve consumir todas as entidades representadas neste fluxo de dados.

appVersionCode: Int32

O valor do atributo de <manifesto c>android:versionCode</c> , do aplicativo que fez backup desse conjunto de dados específico. Isso possibilita que o agente de um aplicativo distingue entre todas as possíveis versões de dados mais antigas quando solicitado a executar a operação de restauração.

newState: ParcelFileDescriptor

Um ParcelFileDescriptor aberto e de leitura/gravação apontando para um arquivo vazio. O aplicativo deve registrar o estado de backup final aqui depois de restaurar seus dados do data fluxo. Quando um conjunto de dados de backup completo estiver sendo restaurado, isso será null.

Atributos: RegisterAttribute

Exceções

IOException

Comentários

O aplicativo está sendo restaurado do backup e deve substituir todos os dados existentes pelo conteúdo do backup. Os dados de backup são fornecidos por meio do data parâmetro. Depois que a restauração for concluída, o aplicativo deverá gravar uma representação do estado final no newState descritor de arquivo.

O aplicativo é responsável por apagar corretamente seus dados antigos e substituí-los pelos dados fornecidos para esse método. Nenhuma operação "limpar dados do usuário" será executada automaticamente pelo sistema operacional. A exceção a isso ocorre no caso de uma tentativa de restauração com falha: se onRestore() lançar uma exceção, o sistema operacional assumirá que os dados do aplicativo agora podem estar em um estado incoerente e os limpará antes de prosseguir.

Java documentação para android.app.backup.BackupAgent.onRestore(android.app.backup.BackupDataInput, int, android.os.ParcelFileDescriptor).

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.

Aplica-se a

OnRestore(BackupDataInput, Int64, ParcelFileDescriptor)

A nova versão trata de um código de #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) versão de aplicativo longo.

[Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;JLandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_JLandroid_os_ParcelFileDescriptor_Handler", ApiSince=28)]
public virtual void OnRestore(Android.App.Backup.BackupDataInput? data, long appVersionCode, Android.OS.ParcelFileDescriptor? newState);

[<Android.Runtime.Register("onRestore", "(Landroid/app/backup/BackupDataInput;JLandroid/os/ParcelFileDescriptor;)V", "GetOnRestore_Landroid_app_backup_BackupDataInput_JLandroid_os_ParcelFileDescriptor_Handler", ApiSince=28)>]
abstract member OnRestore : Android.App.Backup.BackupDataInput * int64 * Android.OS.ParcelFileDescriptor -> unit
override this.OnRestore : Android.App.Backup.BackupDataInput * int64 * Android.OS.ParcelFileDescriptor -> unit

Parâmetros

data: BackupDataInput

appVersionCode: Int64

O valor do <atributo de manifesto a href="[TODO: @docRoot]guide/topics/manifest/manifest-element.html#vcode">android:versionCode</a> manifest, do aplicativo que fez backup desse conjunto de dados específico. Isso possibilita que o agente de um aplicativo distingue entre todas as possíveis versões de dados mais antigas quando solicitado a executar a operação de restauração.

newState: ParcelFileDescriptor

Um ParcelFileDescriptor aberto e de leitura/gravação apontando para um arquivo vazio. O aplicativo deve registrar o estado de backup final aqui depois de restaurar seus dados do <fluxo de código/>dados< de código>. Quando um conjunto de dados de backup completo estiver sendo restaurado, isso será <>código nulo</código>.

Atributos: RegisterAttribute

Comentários

A nova versão trata de um código de #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor) versão de aplicativo longo. A implementação padrão converte o código de versão em um int e chama #onRestore(BackupDataInput, int, android.os.ParcelFileDescriptor).

Java documentação para android.app.backup.BackupAgent.onRestore(android.app.backup.BackupDataInput, long, android.os.ParcelFileDescriptor).

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.

Aplica-se a