Partilhar via


BackgroundTaskBuilder Classe

Definição

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

public ref class BackgroundTaskBuilder sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class BackgroundTaskBuilder final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class BackgroundTaskBuilder
[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

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.

Aplica-se a