BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Methode

Definition

Namespace:

Windows.ApplicationModel.Background

Legt den Ereignistrigger für eine Hintergrundaufgabe fest.

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)

Parameter

trigger

IBackgroundTrigger

Ein instance eines Ereignistriggerobjekts, z. B. SystemTrigger, TimeTrigger oder NetworkOperatorNotificationTrigger.

Hinweise

Zusätzlich zum Angeben des Typs des Ereignistriggers für eine Hintergrundaufgabe muss eine Anwendung auch Hintergrundaufgaben aktivieren, die den Ereignistriggertyp im <Extensions><Extension><BackgroundTasks> Abschnitt des Manifests verwenden. Gültige Typen sind:

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

Wenn der Hintergrundaufgabentyp im Manifest nicht oder falsch angegeben ist, schlagen Aufrufe, die versuchen, diese Art von Hintergrundaufgabe zu verwenden, fehl.

Liste der Trigger:

Trigger	BESCHREIBUNG
ActivitySensorTrigger	Wird verwendet, wenn Ihre Anwendung auf den Aktivitätssensor reagieren muss.
AppBroadcastTrigger	Lösen Sie eine Hintergrundaufgabe aus, die ausgeführt werden soll, wenn eine Anwendung die Gameplayübertragung startet.
ApplicationTrigger	Lösen Sie in Ihrer Anwendung hintergrundaufgaben aus.
AppointmentStoreNotificationTrigger	Trigger zum Starten einer Hintergrundaufgabe zum Verarbeiten von Änderungen am Terminspeicher.
BluetoothLEAdvertisementPublisherTrigger	Stellt einen Trigger dar, der registriert ist, um eine Bluetooth LE-Ankündigung im Hintergrund anzukündigen.
CachedFileUpdaterTrigger	Lösen Sie eine Hintergrundaufgabe aus, um den Vertrag für die Aktualisierung zwischengespeicherter Dateien zu aktivieren.
ChatMessageNotificationTrigger	Stellt einen Trigger dar, der aktiviert wird, wenn eine Benachrichtigung für eine SMS vorhanden ist.
ChatMessageReceivedNotificationTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe startet, die alle eingehenden Nachrichten verarbeitet, die möglicherweise nach ihrem Inhalt gefiltert werden müssen.
CommunicaionBlockingAppSetAsActiveTrigger	Stellt einen Trigger zum Aktivieren einer Kommunikationsblockierungsanwendung dar, wenn sie als bevorzugte blockierende App ausgewählt wird.
ContactStoreNotificationTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe zum Verarbeiten von Änderungen am Kontaktspeicher startet.
ContentPrefetchTrigger	Bietet die Möglichkeit, benutzerdefinierte Handler auszuführen, wenn Webressourcen vorab abgerufen werden.
CustomSystemEventTrigger	Ein benutzerdefinierter Systemtrigger, den Sie definieren können.
DeviceConnectionChangeTrigger	Stellt ein Ereignis dar, das eine Anwendung auslösen kann, um ein update mit langer Ausführungsdauer (Firmware oder Einstellungen) eines Geräts zu initiieren.
DeviceManufacturerNotificationTrigger	Stellt ein Ereignis dar, das eine Anwendung auslösen kann, um ein update mit langer Ausführungsdauer (Firmware oder Einstellungen) eines Geräts zu initiieren.
DeviceUseTrigger	Stellt ein Ereignis dar, das eine Windows-Runtime-App auslösen kann, um einen lang andauernden Vorgang mit einem Gerät oder Sensor zu initiieren.
EmailStoreNotificationTrigger	Stellt einen Trigger dar, der die Benachrichtigung über Änderungen am E-Mail-Speicher ermöglicht.
GattCharacteristicNotificationTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe startet, wenn eine eingehende Änderungsbenachrichtigung für ein Bluetooth LE GATT-Merkmal empfangen wird.
GattServiceProviderTrigger	Erstellt einen GATT-Dienst (Generic Attributes), der im Hintergrund beibehalten werden kann.
GeovisitTrigger	Stellt ein Ereignis dar, das eine Visits-bezogene Hintergrundaufgabe auslöst.
LocationTrigger	Stellt ein Standortereignis dar, das eine Hintergrundaufgabe auslöst. Dies wird für Geofencing verwendet.
MaintenanceTrigger	Stellt einen Wartungstrigger dar, der nur ausgeführt wird, wenn das System an das Netz angeschlossen ist.
MediaProcessingTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe zum Ausführen der Medienverarbeitung startet.
MobileBroadbandDeviceServiceNotificationTrigger	Stellt einen Trigger dar, der aktiviert wird, wenn das Netzwerk SIM-Toolbefehle sendet. Apps, die diese Benachrichtigung erhalten, verarbeiten dann die SIM-Toolbefehle.
MobileBroadbandPcoDataChangeTrigger	Stellt ein Änderungsereignis für die Verbindungsprotokollkonfigurationsoption dar, das die Ausführung einer Hintergrundaufgabe auslöst.
MobileBroadbandPinLockStateChangeTrigger	Stellt einen Trigger dar, der angibt, wann sich der SIM-PIN-Sperrzustand geändert hat.
MobileBroadbandRadioStateChangeTrigger	Stellt einen Trigger dar, der angibt, wann sich der Status des mobilen Breitbandfunks geändert hat. Dieser Trigger wird beispielsweise aktiviert, wenn ein mobiles Gerät in den oder aus dem Flugzeugmodus wechselt.
MobileBroadbandRegistrationStateChangeTrigger	Stellt einen Trigger dar, der angibt, wann sich der Registrierungsstatus des mobilen Breitbands geändert hat. Dieser Trigger wird beispielsweise aktiviert, wenn ein mobiles Gerät zu oder von Roaming wechselt.
NetworkOperatorDataUsageTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe startet, wenn die lokalen Datenzähler schätzen, dass sich die Nutzung (gesendete und empfangene Bytes) auf der mobilen Breitbandschnittstelle um einen umsetzbaren Schwellenwert geändert hat.
NetworkOperatorHotspotAuthenticationTrigger	Stellt einen Hotspot-Authentifizierungstrigger des Mobilfunknetzbetreibers dar.
NetworkOperatorNotificationTrigger	Stellt einen Benachrichtigungstrigger des Mobilfunkanbieters dar.
PaymentAppCanMakePaymentTrigger	Stellt einen PaymentAppCanMakePayment-Trigger dar.
PhoneTrigger	Stellt ein Telefonereignis dar, das eine Hintergrundaufgabe auslöst.
PushNotificationTrigger	Stellt einen Trigger dar, der ein Hintergrundarbeitselement für die App als Reaktion auf den Empfang einer unformatierten Benachrichtigung aufruft.
RcsEndUserMessageAvailableTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe startet, wenn eine neue RCS-Nachricht (Rich Communication Services) verfügbar ist.
RfcommConnectionTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe startet, wenn eingehende oder ausgehende RFCOMM-Verbindungen hergestellt werden.
SecondaryAuthenticationFactorAuthenticationTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe im Namen eines Begleitgeräts startet.
SensorDataThresholdTrigger	Stellt einen Trigger dar, der reagiert, wenn ein Schwellenwert für einen Sensor überschritten wird.
SmartCardTrigger	Stellt ein Ereignis dar, das von einem intelligenten Karte ausgelöst wird.
SmsMessageReceivedTrigger	Stellt einen Trigger dar, der ausgelöst wird, wenn eine SMS-Nachricht eingetroffen ist.
SocketActivityTrigger	Stellt einen Trigger dar, der eine Hintergrundaufgabe zum Behandeln von Socketaktivitäten startet.
StorageLibraryChangeTrackerTrigger	Stellt eine Dateiänderung in einem StorageFolder dar, die eine Auszuführende Hintergrundaufgabe auslöst.
StorageLibraryContentChangedTrigger	Erstellt einen Trigger, der ausgelöst wird, wenn eine Datei in einer angegebenen Bibliothek geändert wird.
SystemCondition	Stellt eine Systembedingung dar, die wirksam sein muss, damit eine Hintergrundaufgabe ausgeführt werden kann.
SystemTrigger	Stellt ein Systemereignis dar, das eine Hintergrundaufgabe auslöst, die ausgeführt werden soll.
TetheringEntitlementCheckTrigger	Stellt ein Tetheringereignis dar, das eine Auszuführende Hintergrundaufgabe auslöst.
TimeTrigger	Stellt ein Zeitereignis dar, das eine Hintergrundaufgabe auslöst, die ausgeführt werden soll.
ToastNotificationActionTrigger	Stellt ein Ereignis dar, das bewirkt, dass eine Hintergrundaufgabe ausgeführt wird, wenn der Benutzer eine Aktion für eine interaktive Popupbenachrichtigung ausführt.
ToastNotificationHistoryChangedTrigger	Stellt ein Ereignis dar, das dazu führt, dass eine Hintergrundaufgabe ausgeführt wird, wenn der Verlauf der Popupbenachrichtigungen für die App gelöscht wird, wenn mindestens eine Popupbenachrichtigung zum Benachrichtigungsverlauf für die App hinzugefügt oder aus dem Benachrichtigungsverlauf entfernt wird oder wenn mindestens eine Popupbenachrichtigung für die App abläuft und aus dem Benachrichtigungsverlauf entfernt wird.
UserNotificationChangedTrigger	Stellt einen Trigger dar, der ausgelöst wird, wenn eine UserNotification hinzugefügt oder entfernt wird.