IBackgroundTaskInstance4 Interface

Referência

Definição

Namespace:: Windows.ApplicationModel.Background

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.

Editar

Fornece acesso a uma instância de tarefa em segundo plano, incluindo informações sobre o usuário.

public interface class IBackgroundTaskInstance4 : IBackgroundTaskInstance

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.Guid(2133455420, 43524, 19208, 151, 176, 6, 216, 116, 205, 171, 245)]
struct IBackgroundTaskInstance4 : IBackgroundTaskInstance

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.Guid(2133455420, 43524, 19208, 151, 176, 6, 216, 116, 205, 171, 245)]
public interface IBackgroundTaskInstance4 : IBackgroundTaskInstance

Public Interface IBackgroundTaskInstance4
Implements IBackgroundTaskInstance

Atributos: ContractVersionAttribute GuidAttribute

Implementações: IBackgroundTaskInstance

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Propriedades

InstanceId	Obtém a ID da instância da tarefa em segundo plano. (Herdado de IBackgroundTaskInstance)
Progress	Obtém ou define status de progresso para uma instância de tarefa em segundo plano. (Herdado de IBackgroundTaskInstance)
SuspendedCount	Obtém o número de vezes que a política de gerenciamento de recursos fez com que a tarefa em segundo plano fosse suspensa. (Herdado de IBackgroundTaskInstance)
Task	Obtém acesso à tarefa em segundo plano registrada para essa instância de tarefa em segundo plano. (Herdado de IBackgroundTaskInstance)
TriggerDetails	Obtém informações adicionais associadas a uma instância de tarefa em segundo plano. (Herdado de IBackgroundTaskInstance)
User	Obtém o contexto do usuário para a tarefa em segundo plano. AppServiceConnection.User é usado pelo aplicativo de chamada para passar o contexto do usuário. O serviço de aplicativo pode recuperar esse contexto de usuário com essa propriedade.

Métodos

GetDeferral()

Informa ao sistema que a tarefa em segundo plano pode continuar a executar o trabalho após o retorno do método IBackgroundTask.Run .

(Herdado de IBackgroundTaskInstance)

Eventos

Canceled

Anexa um manipulador de eventos de cancelamento à instância da tarefa em segundo plano.

Para Windows Phone aplicativo 8.x, se o dispositivo ficar com pouca memória, as tarefas em segundo plano poderão ser encerradas sem nenhum aviso e sem gerar o evento OnCanceled. Isso ajuda a assegurar a experiência do usuário do aplicativo em primeiro plano. A tarefa em segundo plano deve ser projetada para tratar desse cenário. Observe que isso só se aplica a Windows Phone.