BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Método

Definición

Espacio de nombres:

Windows.ApplicationModel.Background

Establece el desencadenador de eventos para una tarea en 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

Instancia de un objeto desencadenador de eventos, como SystemTrigger, TimeTrigger o NetworkOperatorNotificationTrigger.

Comentarios

Además de especificar el tipo de desencadenador de eventos para una tarea en segundo plano, una aplicación también debe habilitar tareas en segundo plano que usen el tipo de desencadenador de eventos en la <Extensions><Extension><BackgroundTasks> sección de su manifiesto. Entre los tipos válidos se incluyen los siguientes:

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

Si el tipo de tarea en segundo plano no se especifica o se especifica incorrectamente en el manifiesto, se producirá un error en las llamadas que intenten usar ese tipo de tarea en segundo plano.

Lista de desencadenadores:

Desencadenador	Descripción
ActivitySensorTrigger	Se usa cuando la aplicación necesita responder al sensor de actividad.
AppBroadcastTrigger	Desencadene una tarea en segundo plano para ejecutarse cuando una aplicación inicia la difusión del juego.
ApplicationTrigger	Desencadene tareas en segundo plano desde dentro de la aplicación.
AppointmentStoreNotificationTrigger	Desencadenador para iniciar una tarea en segundo plano para procesar los cambios en el almacén de citas.
BluetoothLEAdvertisementPublisherTrigger	Representa un desencadenador registrado para anunciar un anuncio bluetooth LE en segundo plano.
CachedFileUpdaterTrigger	Desencadene una tarea en segundo plano para habilitar el contrato del actualizador de archivos almacenados en caché.
ChatMessageNotificationTrigger	Representa un desencadenador que se activa cuando hay una notificación para un mensaje de texto.
ChatMessageReceivedNotificationTrigger	Representa un desencadenador que inicia una tarea en segundo plano que controla cualquier mensaje entrante que pueda necesitar filtrarse según su contenido.
ComunicaciónBlockingAppSetAsActiveTrigger	Representa un desencadenador para activar una aplicación de bloqueo de comunicación cuando se selecciona como aplicación de bloqueo preferida.
ContactStoreNotificationTrigger	Representa un desencadenador que inicia una tarea en segundo plano para procesar los cambios en el almacén de contactos.
ContentPrefetchTrigger	Proporciona la capacidad de ejecutar controladores personalizados al capturar previamente recursos web.
CustomSystemEventTrigger	Un desencadenador del sistema personalizado que puede definir .
DeviceConnectionChangeTrigger	Representa un evento que una aplicación puede desencadenar para iniciar una actualización de ejecución prolongada (firmware o configuración) de un dispositivo.
DeviceManufacturerNotificationTrigger	Representa un evento que una aplicación puede desencadenar para iniciar una actualización de ejecución prolongada (firmware o configuración) de un dispositivo.
DeviceUseTrigger	Representa un evento que una aplicación de Windows Runtime puede desencadenar para iniciar una operación de ejecución prolongada con un dispositivo o sensor.
EmailStoreNotificationTrigger	Representa un desencadenador que habilita la notificación de cambios en el almacén de correo electrónico.
GattCharacteristicNotificationTrigger	Representa un desencadenador que inicia una tarea en segundo plano cuando se recibe una notificación de cambio entrante para una característica GATT de Bluetooth LE.
GattServiceProviderTrigger	Construye un servicio de atributos genéricos (GATT) que se puede conservar en segundo plano.
GeovisitTrigger	Representa un evento que desencadena una tarea en segundo plano relacionada con visitas.
LocationTrigger	Representa un evento de ubicación que desencadena una tarea en segundo plano. Esto se usa para geovalla.
MaintenanceTrigger	Representa un desencadenador de mantenimiento que solo se ejecuta cuando el sistema está conectado a la alimentación de CA.
MediaProcessingTrigger	Representa un desencadenador que inicia una tarea en segundo plano para realizar el procesamiento multimedia.
MobileBroadbandDeviceServiceNotificationTrigger	Representa un desencadenador que se activa cuando la red envía comandos de la herramienta SIM. Las aplicaciones que reciben esta notificación procesan los comandos de la herramienta SIM.
MobileBroadbandPcoDataChangeTrigger	Representa un evento de cambio de opción de configuración del protocolo de telefonía móvil que desencadena una tarea en segundo plano para ejecutarse.
MobileBroadbandPinLockStateChangeTrigger	Representa un desencadenador que indica cuándo ha cambiado el estado de bloqueo del PIN sim.
MobileBroadbandRadioStateChangeTrigger	Representa un desencadenador que indica cuándo ha cambiado el estado de radio de banda ancha móvil. Por ejemplo, este desencadenador se activa cuando un dispositivo móvil pasa a o desde el modo avión.
MobileBroadbandRegistrationStateChangeTrigger	Representa un desencadenador que indica cuándo ha cambiado el estado de registro de banda ancha móvil. Por ejemplo, este desencadenador se activa cuando un dispositivo móvil realiza la transición hacia o desde Roaming.
NetworkOperatorDataUsageTrigger	Representa un desencadenador que inicia una tarea en segundo plano cuando los contadores de datos locales calculan que el uso (bytes enviados y recibidos) en la interfaz de banda ancha móvil ha cambiado por un umbral accionable.
NetworkOperatorHotspotAuthenticationTrigger	Representa un desencadenador de autenticación de la zona activa del operador de red móvil.
NetworkOperatorNotificationTrigger	Representa un desencadenador de notificación de operador de red móvil.
PaymentAppCanMakePaymentTrigger	Representa un desencadenador PaymentAppCanMakePayment.
PhoneTrigger	Representa un evento telefónico que desencadena una tarea en segundo plano.
PushNotificationTrigger	Representa un desencadenador que invoca un elemento de trabajo en segundo plano en la aplicación en respuesta a la recepción de una notificación sin procesar.
RcsEndUserMessageAvailableTrigger	Representa un desencadenador que inicia una tarea en segundo plano cuando hay disponible un nuevo mensaje de Rich Communication Services (RCS).
RfcommConnectionTrigger	Representa un desencadenador que inicia una tarea en segundo plano cuando se establecen conexiones entrantes o salientes de RFCOMM.
SecondaryAuthenticationFactorAuthenticationTrigger	Representa un desencadenador que inicia una tarea en segundo plano en nombre de un dispositivo complementario.
SensorDataThresholdTrigger	Representa un desencadenador que responde cuando se cruza un límite de umbral para un sensor.
SmartCardTrigger	Representa un evento desencadenado por una tarjeta inteligente.
SmsMessageReceivedTrigger	Representa un desencadenador que se genera cuando ha llegado un mensaje SMS.
SocketActivityTrigger	Representa un desencadenador que inicia una tarea en segundo plano para controlar la actividad del socket.
StorageLibraryChangeTrackerTrigger	Representa un cambio de archivo dentro de una clase StorageFolder que desencadena una tarea en segundo plano que se va a ejecutar.
StorageLibraryContentChangedTrigger	Crea un desencadenador que se activará cuando se cambie un archivo en una biblioteca especificada.
SystemCondition	Representa una condición del sistema que debe estar en vigor para que se ejecute una tarea en segundo plano.
SystemTrigger	Representa un evento del sistema que desencadena una tarea en segundo plano que se va a ejecutar.
TetheringEntitlementCheckTrigger	Representa un evento de tethering que desencadena una tarea en segundo plano que se va a ejecutar.
TimeTrigger	Representa un evento de hora que desencadena una tarea en segundo plano que se va a ejecutar.
ToastNotificationActionTrigger	Representa un evento que hace que se ejecute una tarea en segundo plano cuando el usuario realiza una acción en una notificación del sistema interactiva.
ToastNotificationHistoryChangedTrigger	Representa un evento que hace que se ejecute una tarea en segundo plano cuando se borra el historial de notificaciones del sistema de la aplicación, cuando se agregan o quitan una o varias notificaciones del sistema del historial de notificaciones de la aplicación, o cuando una o varias notificaciones del sistema para la aplicación expiran y se quitan del historial de notificaciones.
UserNotificationChangedTrigger	Representa un desencadenador que se activa cuando se agrega o quita un UserNotification.