Compartilhar via


BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Método

Definição

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.

Aplica-se a