Share via


IBackgroundTaskInstance2 Interface

Definição

Fornece acesso a uma instância de tarefa em segundo plano. Herda da interface IBackgroundTaskInstance e adiciona o método GetThrottleCount .

public interface class IBackgroundTaskInstance2 : IBackgroundTaskInstance
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1333592438, 3190, 20404, 137, 109, 93, 225, 134, 65, 34, 246)]
struct IBackgroundTaskInstance2 : IBackgroundTaskInstance
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1333592438, 3190, 20404, 137, 109, 93, 225, 134, 65, 34, 246)]
public interface IBackgroundTaskInstance2 : IBackgroundTaskInstance
Public Interface IBackgroundTaskInstance2
Implements IBackgroundTaskInstance
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.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)

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)
GetThrottleCount(BackgroundTaskThrottleCounter)

Recupera o número de vezes que a tarefa em segundo plano foi suspensa por usar muitos recursos.

Eventos

Canceled

Anexa um manipulador de eventos de cancelamento à instância de 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.

(Herdado de IBackgroundTaskInstance)

Aplica-se a

Confira também