Windows.ApplicationModel.Background Namespace

Permite que um aplicativo agende tarefas em segundo plano para executar o código do aplicativo mesmo quando o aplicativo é suspenso.

As tarefas em segundo plano destinam-se a pequenos itens de trabalho que não exigem interação do usuário ou para lidar com ações do sistema. Os cenários apropriados para tarefas em segundo plano incluem baixar emails, mostrar uma notificação do sistema para uma mensagem de chat recebida ou reagir a uma alteração em uma condição do sistema.

Consulte Suporte ao seu aplicativo com tarefas em segundo plano (usando JavaScript e HTML) ou Suporte ao seu aplicativo com tarefas em segundo plano para obter diretrizes sobre como implementar tarefas em segundo plano. Por exemplo, código que mostra como implementar tarefas em segundo plano, consulte o Exemplo de tarefa em segundo plano.

Classes

ActivitySensorTrigger	Representa um gatilho que é ativado quando ActivitySensor recebe entrada. Isso é usado quando seu aplicativo precisa responder ao sensor de atividade.
AlarmApplicationManager	Solicita permissão do usuário para definir alarmes e recupera o status de permissão do usuário para o aplicativo definir alarmes.
AppBroadcastTrigger	Representa um evento que dispara uma tarefa em segundo plano a ser executada quando um aplicativo inicia a transmissão de jogo.
AppBroadcastTriggerProviderInfo	Fornece informações sobre o aplicativo que está transmitindo a jogabilidade, como seu logotipo, nome de exibição e características de vídeo.
ApplicationTrigger	Isso permite que você dispare programaticamente uma tarefa em segundo plano de dentro do aplicativo.
ApplicationTriggerDetails	Os detalhes de um ApplicationTrigger.
AppointmentStoreNotificationTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para processar alterações no repositório de compromissos.
BackgroundExecutionManager	Gerenciar permissão para executar tarefas em segundo plano.
BackgroundTaskBuilder	Representa uma tarefa em segundo plano a ser registrada no sistema.
BackgroundTaskCompletedEventArgs	Representa informações de conclusão de uma tarefa no momento em que uma notificação de conclusão é enviada.
BackgroundTaskDeferral	Representa um adiamento de tarefa em segundo plano retornado pelo método IBackgroundTaskInstance.GetDeferral .
BackgroundTaskProgressEventArgs	Representa informações de progresso para uma tarefa no momento em que uma notificação de atualização de progresso é enviada.
BackgroundTaskRegistration	Representa uma tarefa em segundo plano que foi registrada com o sistema.
BackgroundTaskRegistrationGroup	Fornece semântica de agrupamento para que o registro de tarefas em segundo plano possa ser mantido separadamente.
BackgroundWorkCost	Recupera uma dica sobre a disponibilidade de recursos para tarefas em segundo plano. As tarefas em segundo plano podem usar essa dica para decidir quanto trabalho fazer quando são ativadas.
BluetoothLEAdvertisementPublisherTrigger	Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em segundo plano.
BluetoothLEAdvertisementWatcherTrigger	Representa um gatilho registrado para verificar se há anúncio de LE Bluetooth em segundo plano.
CachedFileUpdaterTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para habilitar o contrato do Atualizador de Arquivos Armazenado em Cache.
CachedFileUpdaterTriggerDetails	Fornece detalhes sobre a operação de arquivo armazenado em cache que invocou o gatilho.
ChatMessageNotificationTrigger	Representa um gatilho que é ativado quando há uma notificação para uma mensagem de texto.
ChatMessageReceivedNotificationTrigger	Representa um gatilho que inicia uma tarefa em segundo plano que manipula qualquer mensagem de entrada que possa precisar ser filtrada de acordo com seu conteúdo. Para obter mais informações sobre como filtrar mensagens, consulte Windows.ApplicationModel.CommunicationBlocking.
CommunicationBlockingAppSetAsActiveTrigger	Representa um gatilho para ativar um aplicativo de bloqueio de comunicação quando ele é selecionado como o aplicativo de bloqueio preferencial. Um usuário pode ter vários aplicativos de bloqueio de comunicação instalados ao mesmo tempo. Esse gatilho é usado para informar um aplicativo que ele foi selecionado como o aplicativo de bloqueio de comunicação ativo. Para obter mais informações sobre a API de bloqueio de comunicação, consulte Windows.ApplicationModel.CommunicationBlocking.
ContactStoreNotificationTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para processar alterações no repositório de contatos.
ContentPrefetchTrigger	Fornece a capacidade de executar manipuladores personalizados ao pré-busca de recursos da Web.
ConversationalAgentTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para processar a comunicação de assistente digital por meio do AAR (Tempo de Execução de Ativação do Agente da plataforma Windows).
CustomSystemEventTrigger	Essa classe permite que você especifique um gatilho de sistema personalizado para que você possa registrá-lo e responder quando ele for disparado pelo sistema.
DeviceConnectionChangeTrigger	Representa um gatilho que inicia uma tarefa em segundo plano quando a conexão status de um dispositivo é alterada.
DeviceManufacturerNotificationTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para habilitar operações do fabricante do dispositivo.
DeviceServicingTrigger	Representa um evento que um aplicativo pode disparar para iniciar uma atualização de longa execução (firmware ou configurações) de um dispositivo. Windows 8.1 permite desenvolver o aplicativo UWP para seus dispositivos periféricos que se comunicam por USB, HID e Bluetooth. Por exemplo, um usuário pode precisar sincronizar conteúdo em um computador de ou para o dispositivo ou executar uma atualização de longa execução para o próprio dispositivo, como configurações ou atualizações de firmware. Windows 8.1 fornece duas tarefas em segundo plano e APIs correspondentes que permitem que seu dispositivo sincronize e atualize em segundo plano: DeviceServicingTrigger e DeviceUseTrigger. Este tópico fornece informações de referência de API para DeviceServicingTrigger – para obter informações sobre como usar esse gatilho no contexto de um aplicativo de dispositivo, consulte Sincronização de dispositivos e atualização para aplicativos de dispositivo UWP. A tarefa em segundo plano DeviceServicingTrigger permite que seu aplicativo UWP que interage com seu dispositivo periférico execute atualizações de dispositivo de longa execução enquanto seu aplicativo está suspenso, por exemplo, transferências de configurações ou atualizações de firmware. Atualizar o dispositivo em segundo plano requer a aprovação do usuário sempre que a tarefa em segundo plano é usada. Ao contrário da tarefa em segundo plano DeviceUseTrigger , a tarefa em segundo plano DeviceServicingTrigger permite a reinicialização e desconexão do dispositivo e permite no máximo 30 minutos de atividade em segundo plano. Mais detalhes sobre os requisitos de política da tarefa em segundo plano DeviceServicingTrigger podem ser encontrados na seção desta página. Para obter informações sobre como usar o DeviceServicingTrigger, consulte Sincronização de dispositivos e atualização para aplicativos de dispositivo UWP. Para obter informações sobre como usar o DeviceUseTrigger, consulte Acessando sensores e dispositivos de uma tarefa em segundo plano. Importante Esse gatilho não pode ser usado com tarefas em segundo plano de processo único.
DeviceUseTrigger	Representa um evento que um aplicativo Windows Runtime pode disparar para iniciar uma operação de longa execução com um dispositivo ou sensor. DeviceUseTrigger permite que seu aplicativo Windows Runtime acesse sensores e dispositivos periféricos em segundo plano, mesmo quando seu aplicativo em primeiro plano é suspenso. Por exemplo, dependendo de onde o seu aplicativo estiver sendo executado, ele poderá usar uma tarefa em segundo plano para sincronizar dados com dispositivos ou monitorar sensores. Essa classe pode ser usada no aplicativo UWP e Windows Phone aplicativo 8.x. No entanto, uma tarefa em segundo plano do DeviceUseTrigger dá suporte a APIs diferentes e está sujeita a políticas diferentes, dependendo de onde está em execução (computador ou telefone). Para saber mais sobre essas diferenças, consulte Acessando sensores e dispositivos de uma tarefa em segundo plano. Importante Esse gatilho não pode ser usado com tarefas em segundo plano de processo único. Para obter um exemplo que mostra como usar DeviceUseTrigger em um computador, consulte o exemplo de dispositivo USB personalizado. Para obter um exemplo de telefone, consulte o exemplo sensores de plano de fundo.
DeviceWatcherTrigger	Representa um evento que faz com que uma tarefa em segundo plano seja executada quando ocorrem alterações na lista de dispositivos. Retornado por GetBackgroundTrigger.
EmailStoreNotificationTrigger	Representa um gatilho que habilita a notificação de alterações no repositório de emails.
GattCharacteristicNotificationTrigger	Representa um gatilho que inicia uma tarefa em segundo plano quando uma notificação de alteração de entrada é recebida para uma característica de GATT DE LE Bluetooth.
GattServiceProviderTrigger	Constrói um serviço GATT (Atributos Genéricos) que pode ser persistido em segundo plano.
GattServiceProviderTriggerResult	Essa classe contém o gatilho criado por GattServiceProviderTrigger.CreateAsync().
GeovisitTrigger	Representa um evento que dispara uma tarefa em segundo plano relacionada a Visitas.
LocationTrigger	Representa um evento de local que dispara uma tarefa em segundo plano. Isso é usado para cerca geográfica.
MaintenanceTrigger	Representa um gatilho de manutenção.
MediaProcessingTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para executar o processamento de mídia.
MobileBroadbandDeviceServiceNotificationTrigger	Representa um gatilho que é ativado quando a rede envia comandos da ferramenta SIM. Os aplicativos que recebem essa notificação processam os comandos da ferramenta SIM. Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.
MobileBroadbandPcoDataChangeTrigger	Representa um evento de alteração de opção de configuração de protocolo celular que dispara uma tarefa em segundo plano a ser executada.
MobileBroadbandPinLockStateChangeTrigger	Representa um gatilho que indica quando o estado de bloqueio do PIN do SIM foi alterado. Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.
MobileBroadbandRadioStateChangeTrigger	Representa um gatilho que indica quando o estado de rádio de banda larga móvel foi alterado. Por exemplo, esse gatilho é ativado quando um dispositivo móvel faz a transição de ou para o modo avião. Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.
MobileBroadbandRegistrationStateChangeTrigger	Representa um gatilho que indica quando o estado de registro de banda larga móvel foi alterado. Por exemplo, esse gatilho é ativado quando um dispositivo móvel faz a transição de ou para Roaming. Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.
NetworkOperatorDataUsageTrigger	Representa um gatilho que inicia uma tarefa em segundo plano quando os contadores de dados locais estimam que o uso (bytes enviados e recebidos) na interface de banda larga móvel foi alterado por um limite acionável. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará de aprovação especial. Para obter mais informações, consulte a seção Funcionalidades restritas no tópico Declarações de funcionalidade do aplicativo e Banda Larga Móvel.
NetworkOperatorHotspotAuthenticationTrigger	Representa um gatilho de autenticação de hotspot da operadora de rede móvel. Observação Um aplicativo só pode instanciar esse objeto e registrar-se para o evento de autenticação de hotspot depois que um perfil WLAN foi provisionado que faz referência a esse aplicativo para lidar com a autenticação de hotspot. Para obter mais informações, consulte Integração do Windows 8 para operadores de hotspot sem fio.
NetworkOperatorNotificationTrigger	Representa um gatilho de notificação da operadora de rede móvel.
PaymentAppCanMakePaymentTrigger	Essa classe representa um gatilho PaymentAppCanMakePayment.
PhoneTrigger	Representa um evento de telefone que dispara uma tarefa em segundo plano.
PushNotificationTrigger	Representa um objeto que invoca um item de trabalho em segundo plano no aplicativo em resposta ao recebimento de uma notificação bruta.
RcsEndUserMessageAvailableTrigger	Representa um gatilho que inicia uma tarefa em segundo plano quando uma nova mensagem dos Serviços de Comunicação Avançada (RCS) está disponível.
RfcommConnectionTrigger	Representa um gatilho que inicia uma tarefa em segundo plano quando uma conexão de entrada ou saída RFCOMM é estabelecida.
SecondaryAuthenticationFactorAuthenticationTrigger	Representa um gatilho que inicia uma tarefa em segundo plano em nome de um dispositivo complementar.
SensorDataThresholdTrigger	Representa um gatilho que responde quando um limite de um sensor é cruzado.
SmartCardTrigger	Representa um evento disparado por um cartão inteligente.
SmsMessageReceivedTrigger	Representa um gatilho que é gerado quando uma mensagem SMS chega.
SocketActivityTrigger	Representa um gatilho que inicia uma tarefa em segundo plano para lidar com a atividade de soquete.
StorageLibraryChangeTrackerTrigger	Representa uma alteração de arquivo em uma StorageFolder que dispara uma tarefa em segundo plano a ser executada.
StorageLibraryContentChangedTrigger	Cria um gatilho que será acionado quando um arquivo for alterado em uma biblioteca especificada.
SystemCondition	Representa uma condição do sistema que deve estar em vigor para que uma tarefa em segundo plano seja executada.
SystemTrigger	Representa um evento do sistema que dispara uma tarefa em segundo plano a ser executada.
TetheringEntitlementCheckTrigger	Representa um evento de amarração que dispara uma tarefa em segundo plano a ser executada.
TimeTrigger	Representa um evento de tempo que dispara uma tarefa em segundo plano a ser executada.
ToastNotificationActionTrigger	Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o usuário executa uma ação em uma notificação interativa do sistema.
ToastNotificationHistoryChangedTrigger	Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o histórico de notificações do sistema para o aplicativo é limpo, quando uma ou mais notificações do sistema são adicionadas ou removidas do histórico de notificações do aplicativo ou quando uma ou mais notificações do sistema para o aplicativo expiram e são removidas do histórico de notificações.
UserNotificationChangedTrigger	Representa um gatilho que é acionado quando uma UserNotification é adicionada ou removida.
WiFiOnDemandHotspotConnectTrigger	Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o usuário deseja se conectar a uma rede de hotspot sob demanda específica. O código da tarefa em segundo plano deve converter o valor da propriedade IBackgroundTaskInstance.TriggerDetails em WiFiOnDemandHotspotConnectTriggerDetails. Observação Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados. A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.
WiFiOnDemandHotspotUpdateMetadataTrigger	Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o usuário abre o sistema operacional (SO) Wi-Fi lista de rede, como se se conectasse a uma nova rede Wi-Fi. Observação Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados. A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.

Interfaces

IBackgroundCondition	Usado para impor o tipo de objeto de condição do sistema.
IBackgroundTask	Fornece um método para executar o trabalho de uma tarefa em segundo plano.
IBackgroundTaskInstance	Fornece acesso a uma instância de tarefa em segundo plano.
IBackgroundTaskInstance2	Fornece acesso a uma instância de tarefa em segundo plano. Herda da interface IBackgroundTaskInstance e adiciona o método GetThrottleCount .
IBackgroundTaskInstance4	Fornece acesso a uma instância de tarefa em segundo plano, incluindo informações sobre o usuário.
IBackgroundTaskRegistration	Fornece acesso a uma tarefa em segundo plano registrada.
IBackgroundTaskRegistration2	Fornece acesso a uma tarefa em segundo plano registrada. Herda da interface IBackgroundTaskRegistration e adiciona a propriedade Trigger .
IBackgroundTaskRegistration3	Representa uma tarefa em segundo plano que foi registrada como parte de um grupo de tarefas em segundo plano relacionadas.
IBackgroundTrigger	Representa a interface base para eventos de gatilho.

Enumerações

AlarmAccessStatus	Indica se o usuário deu permissão para o aplicativo definir alarmes.
ApplicationTriggerResult	O resultado da solicitação para disparar uma tarefa em segundo plano. O método RequestAsync retorna um valor desse tipo de enumeração.
BackgroundAccessRequestKind	Especifica o nível de atividade em segundo plano que um aplicativo pode solicitar.
BackgroundAccessStatus	Essa enumeração especifica a capacidade de um aplicativo de executar atividades em segundo plano. Os aplicativos devem chamar BackgroundExecutionManager.RequestAccessAsync com êxito antes de registrar tarefas em segundo plano.
BackgroundTaskCancellationReason	Especifica os motivos para cancelar uma tarefa em segundo plano.
BackgroundTaskThrottleCounter	Indica o tipo de contagem de limitação para marcar em uma solicitação GetThrottleCount.
BackgroundWorkCostValue	Indica o custo atual de fazer trabalho em segundo plano. Usado como uma dica para tarefas em segundo plano sobre quanto trabalho eles podem fazer.
CustomSystemEventTriggerRecurrence	Especifica quando um CustomSystemEventTrigger pode ser ativado.
DeviceTriggerResult	Indica se a operação de tarefa em segundo plano do dispositivo foi permitida ou negada e, se foi negada, especifica o motivo.
EnergyUseLevel	Permite que um aplicativo agende tarefas em segundo plano para executar o código do aplicativo mesmo quando o aplicativo é suspenso. As tarefas em segundo plano destinam-se a pequenos itens de trabalho que não exigem interação do usuário ou para lidar com ações do sistema. Os cenários apropriados para tarefas em segundo plano incluem baixar emails, mostrar uma notificação do sistema para uma mensagem de chat recebida ou reagir a uma alteração em uma condição do sistema. Consulte Suporte ao seu aplicativo com tarefas em segundo plano (usando JavaScript e HTML) ou Suporte ao seu aplicativo com tarefas em segundo plano para obter diretrizes sobre como implementar tarefas em segundo plano. Por exemplo, código que mostra como implementar tarefas em segundo plano, consulte o Exemplo de tarefa em segundo plano.
LocationTriggerType	Indica um tipo de evento de local para um gatilho de tarefa em segundo plano de localização.
MediaProcessingTriggerResult	Especifica o resultado de uma chamada para MediaProcessingTrigger.RequestAsync.
SystemConditionType	Especifica uma condição do sistema que deve estar em vigor para que uma tarefa em segundo plano seja executada. Se uma tarefa em segundo plano com uma condição do sistema for disparada, a tarefa não será executada até que a condição seja atendida.
SystemTriggerType	Especifica os eventos do sistema que podem ser usados para disparar uma tarefa em segundo plano.

Delegados

BackgroundTaskCanceledEventHandler	Representa um método que manipula o cancelamento de uma tarefa em segundo plano.
BackgroundTaskCompletedEventHandler	Representa um método que manipula eventos de conclusão para uma tarefa em segundo plano.
BackgroundTaskProgressEventHandler	Representa um método que manipula eventos de atualização de progresso para uma tarefa em segundo plano.

Confira também

• Exemplo de tarefa em segundo plano (Windows 10)
• Exemplo de execução estendida (Windows 10)
• Exemplo de dispositivo USB personalizado (Windows 10)
• Exemplo de bloqueio e filtragem de comunicação
• Exemplo de ativação em segundo plano
• Exemplo de DatagramSocket
• Exemplo do StreamSocket
• Exemplo de código adaptável de versão