Freigeben über

BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Methode

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.Background
Bearbeiten

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.

Gilt für: