Activity.OnSaveInstanceState Método

Definição

Namespace:: Android.App

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
OnSaveInstanceState(Bundle)	Chamado para recuperar o estado por instância de uma atividade antes de ser morto para que o estado possa ser restaurado em onCreate(Bundle) ou onRestoreInstanceState(Bundle) (o pacote preenchido por esse método será passado para ambos).
OnSaveInstanceState(Bundle, PersistableBundle)	Isso é o mesmo que onSaveInstanceState(Bundle), mas é chamado para atividades criadas com o atributo R.attr.persistableMode definido como persistAcrossReboots.

OnSaveInstanceState(Bundle)

[Android.Runtime.Register("onSaveInstanceState", "(Landroid/os/Bundle;)V", "GetOnSaveInstanceState_Landroid_os_Bundle_Handler")]
protected virtual void OnSaveInstanceState(Android.OS.Bundle outState);

[<Android.Runtime.Register("onSaveInstanceState", "(Landroid/os/Bundle;)V", "GetOnSaveInstanceState_Landroid_os_Bundle_Handler")>]
abstract member OnSaveInstanceState : Android.OS.Bundle -> unit
override this.OnSaveInstanceState : Android.OS.Bundle -> unit

Parâmetros

outState: Bundle

Pacote: agrupar no qual colocar o estado salvo. Esse valor não pode ser nulo.

Atributos: RegisterAttribute

Comentários

Chamado para recuperar o estado por instância de uma atividade antes de ser morto para que o estado possa ser restaurado em onCreate(Bundle) ou onRestoreInstanceState(Bundle) (o pacote preenchido por esse método será passado para ambos). Esse método é chamado antes que uma atividade possa ser encerrada para que, quando voltar em algum momento no futuro, possa restaurar seu estado. Por exemplo, se a atividade B for iniciada na frente da atividade A e, em algum momento, a atividade A for interrompida para recuperar recursos, a atividade A terá a chance de salvar o estado atual de sua interface do usuário por meio desse método para que, quando o usuário retornar à atividade A, o estado da interface do usuário possa ser restaurado por meio de onCreate(Bundle) ou onRestoreInstanceState(Bundle). Não confunda esse método com retornos de chamada do ciclo de vida da atividade, como onPause(), que é sempre chamado quando o usuário não interage mais ativamente com uma atividade ou onStop() que é chamado quando a atividade se torna invisível. Um exemplo de quando onPause() e onStop() é chamado e não esse método é quando um usuário navega de volta da atividade B para a atividade A: não há necessidade de chamar onSaveInstanceState(Bundle) em B porque essa instância específica nunca será restaurada, portanto, o sistema evita chamá-la. Um exemplo quando onPause() é chamado e não onSaveInstanceState(Bundle) é quando a atividade B é iniciada na frente da atividade A: o sistema pode evitar chamar onSaveInstanceState(Bundle) na atividade A se ela não for morta durante o tempo de vida de B, uma vez que o estado da interface do usuário de A permanecerá intacto. A implementação padrão cuida da maior parte do estado da interface do usuário por instância para você chamando View.onSaveInstanceState() em cada exibição na hierarquia que tem uma ID e salvando a ID do modo de exibição focado no momento (tudo isso é restaurado pela implementação padrão de onRestoreInstanceState(Bundle)). Se você substituir esse método para salvar informações adicionais não capturadas por cada exibição individual, provavelmente desejará chamar a implementação padrão, caso contrário, esteja preparado para salvar todo o estado de cada exibição por conta própria. Se chamado, esse método ocorrerá após onStop() para aplicativos direcionados a plataformas que começam com Build.VERSION_CODES.P. Para aplicativos destinados a versões anteriores da plataforma, esse método ocorrerá antes de onStop() e não há garantias sobre se ele ocorrerá antes ou depois de onPause().

Consulte também:

Referência do Android para android.app.Activity.onSaveInstanceState.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

OnSaveInstanceState(Bundle, PersistableBundle)

Isso é o mesmo que onSaveInstanceState(Bundle), mas é chamado para atividades criadas com o atributo R.attr.persistableMode definido como persistAcrossReboots.

[Android.Runtime.Register("onSaveInstanceState", "(Landroid/os/Bundle;Landroid/os/PersistableBundle;)V", "GetOnSaveInstanceState_Landroid_os_Bundle_Landroid_os_PersistableBundle_Handler")]
public virtual void OnSaveInstanceState(Android.OS.Bundle outState, Android.OS.PersistableBundle outPersistentState);

[<Android.Runtime.Register("onSaveInstanceState", "(Landroid/os/Bundle;Landroid/os/PersistableBundle;)V", "GetOnSaveInstanceState_Landroid_os_Bundle_Landroid_os_PersistableBundle_Handler")>]
abstract member OnSaveInstanceState : Android.OS.Bundle * Android.OS.PersistableBundle -> unit
override this.OnSaveInstanceState : Android.OS.Bundle * Android.OS.PersistableBundle -> unit