BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Método

Definição

Namespace:

Windows.ApplicationModel.Background

Define o gatilho de evento para uma tarefa em segundo plano.

public:
 virtual void SetTrigger(IBackgroundTrigger ^ trigger) = SetTrigger;

void SetTrigger(IBackgroundTrigger const& trigger);

public void SetTrigger(IBackgroundTrigger trigger);

function setTrigger(trigger)

Public Sub SetTrigger (trigger As IBackgroundTrigger)

Parâmetros

trigger

IBackgroundTrigger

Uma instância de um objeto de gatilho de evento, como SystemTrigger, TimeTrigger ou NetworkOperatorNotificationTrigger.

Comentários

Além de especificar o tipo de gatilho de evento para uma tarefa em segundo plano, um aplicativo também deve habilitar tarefas em segundo plano que usam o tipo de gatilho de evento na <Extensions><Extension><BackgroundTasks> seção de seu manifesto. Os tipos válidos incluem:

• <Task Type="audio"/>
• <Task Type="timer"/>
• <Task Type="systemEvent"/>
• <Task Type="pushNotification"/>
• <Task Type="realTimeCommunication"/>

Se o tipo de tarefa em segundo plano não for especificado ou especificado incorretamente no manifesto, as chamadas que tentarem usar esse tipo de tarefa em segundo plano falharão.

Lista de gatilhos:

Gatilho	Descrição
ActivitySensorTrigger	Usado quando seu aplicativo precisa responder ao sensor de atividade.
AppBroadcastTrigger	Dispare uma tarefa em segundo plano para ser executada quando um aplicativo iniciar a transmissão de jogo.
ApplicationTrigger	Dispare uma tarefa em segundo plano de dentro do aplicativo.
AppointmentStoreNotificationTrigger	Gatilho para iniciar uma tarefa em segundo plano para processar alterações no repositório de compromissos.
BluetoothLEAdvertisementPublisherTrigger	Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em segundo plano.
CachedFileUpdaterTrigger	Dispare uma tarefa em segundo plano para habilitar o contrato do Atualizador de Arquivos Armazenado em Cache.
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.
CommunicaionBlockingAppSetAsActiveTrigger	Representa um gatilho para ativar um aplicativo de bloqueio de comunicação quando ele é selecionado como o aplicativo de bloqueio preferencial.
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.
CustomSystemEventTrigger	Um gatilho de sistema personalizado que você pode definir .
DeviceConnectionChangeTrigger	Representa um evento que um aplicativo pode disparar para iniciar uma atualização de longa execução (firmware ou configurações) de um dispositivo.
DeviceManufacturerNotificationTrigger	Representa um evento que um aplicativo pode disparar para iniciar uma atualização de longa execução (firmware ou configurações) de um dispositivo.
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.
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.
GeovisitTrigger	Representa um evento que dispara uma tarefa em segundo plano relacionada a Visitas.
LocationTrigger	Representa um evento de localização que dispara uma tarefa em segundo plano. Isso é usado para Geofencing.
MaintenanceTrigger	Representa um gatilho de manutenção que é executado somente quando o sistema está conectado à energia ac.
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 de ferramenta SIM. Os aplicativos que recebem essa notificação processam os comandos da ferramenta SIM.
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.
MobileBroadbandRadioStateChangeTrigger	Representa um gatilho que indica quando o estado da 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.
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.
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.
NetworkOperatorHotspotAuthenticationTrigger	Representa um gatilho de autenticação de hotspot da operadora de rede móvel.
NetworkOperatorNotificationTrigger	Representa um gatilho de notificação da operadora de rede móvel.
PaymentAppCanMakePaymentTrigger	Representa um gatilho PaymentAppCanMakePayment.
PhoneTrigger	Representa um evento de telefone que dispara uma tarefa em segundo plano.
PushNotificationTrigger	Representa um gatilho 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 para um sensor é cruzado.
SmartCardTrigger	Representa um evento disparado por um cartão inteligente.
SmsMessageReceivedTrigger	Representa um gatilho 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.