BackgroundTaskBuilder Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa uma tarefa em segundo plano a ser registrada no sistema.

public ref class BackgroundTaskBuilder sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTaskBuilder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTaskBuilder

function BackgroundTaskBuilder()

Public NotInheritable Class BackgroundTaskBuilder

Herança

Object Platform::Object IInspectable BackgroundTaskBuilder

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Se sua tarefa em segundo plano exigir conectividade de rede, esteja ciente do seguinte:

** Gatilhos relacionados à rede**

• Use um SocketActivityTrigger para ativar a tarefa em segundo plano quando um pacote é recebido e você precisa executar uma tarefa de curta duração. Depois de executar a tarefa, é necessário encerrar a tarefa em segundo plano para economizar energia.
• Use um ControlChannelTrigger para ativar a tarefa em segundo plano quando um pacote é recebido e você precisa executar uma tarefa de longa duração.

**Condições e sinalizadores relacionados à rede**

• Adicione a condição InternetAvailable (BackgroundTaskBuilder.AddCondition) à sua tarefa em segundo plano para atrasar o disparo da tarefa em segundo plano até que a pilha de rede esteja em execução. Essa condição economiza energia porque a tarefa em segundo plano não será executada até que o acesso à rede esteja disponível. Essa condição não fornece ativação em tempo real.

Independentemente do gatilho usado, defina IsNetworkRequested na tarefa em segundo plano para garantir que a rede permaneça ativa enquanto a tarefa em segundo plano é executada. Isso solicita que a infraestrutura de tarefas em segundo plano acompanhe a rede enquanto a tarefa está em execução, mesmo se o dispositivo entrar no modo de Espera Conectado. Se sua tarefa em segundo plano não usar IsNetworkRequested, sua tarefa em segundo plano não poderá acessar a rede quando estiver no modo de Espera Conectada (por exemplo, quando a tela de um telefone estiver desativada).)

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	TaskGroup
2004	19041	SetTaskEntryPointClsid

Construtores

BackgroundTaskBuilder()

Cria uma instância da classe BackgroundTaskBuilder .

Propriedades

AllowRunningTaskInStandby	Representa uma tarefa em segundo plano a ser registrada no sistema.
CancelOnConditionLoss	Indica se a tarefa em segundo plano será cancelada se pelo menos uma de suas condições necessárias não for mais atendida.
IsNetworkRequested	Indica se a rede deve ser mantida em funcionamento durante a execução da tarefa em segundo plano.
IsRunningTaskInStandbySupported	Representa uma tarefa em segundo plano a ser registrada no sistema.
Name	Obtém ou define o nome de uma tarefa em segundo plano.
TaskEntryPoint	Obtém ou define a classe que executa o trabalho de uma tarefa em segundo plano.
TaskGroup	Obtém e define o identificador de grupo.

Métodos

AddCondition(IBackgroundCondition)	Adiciona uma condição a uma tarefa em segundo plano.
Register()	Registra uma tarefa em segundo plano com o sistema.
Register(String)	Representa uma tarefa em segundo plano a ser registrada no sistema.
SetTaskEntryPointClsid(Guid)	Atribui um ponto de entrada COM CLSID usando um objeto BackgroundTaskBuilder existente.
SetTrigger(IBackgroundTrigger)	Define o gatilho de evento para uma tarefa em segundo plano.
Validate()	Representa uma tarefa em segundo plano a ser registrada no sistema.