Freigeben über


DeviceUseTrigger Klasse

Definition

Stellt ein Ereignis dar, das eine Windows-Runtime-App auslösen kann, um einen Vorgang mit langer Ausführungsdauer mit einem Gerät oder Sensor zu initiieren.

DeviceUseTrigger ermöglicht Ihrem Windows-Runtime App den Zugriff auf Sensoren und Peripheriegeräte im Hintergrund, auch wenn Ihre Vordergrund-App angehalten ist. Je nachdem, wo Ihre App ausgeführt wird, kann sie eine Hintergrundaufgabe zum Synchronisieren von Daten mit Geräten oder zum Überwachen von Sensoren verwenden.

Diese Klasse kann in der UWP-App und Windows Phone 8.x-App verwendet werden. Eine DeviceUseTrigger-Hintergrundaufgabe unterstützt jedoch unterschiedliche APIs und unterliegt unterschiedlichen Richtlinien, je nachdem, wo sie ausgeführt wird (PC oder Smartphone). Weitere Informationen zu diesen Unterschieden finden Sie unter Zugreifen auf Sensoren und Geräte über eine Hintergrundaufgabe.

Wichtig

Dieser Trigger kann nicht mit Einzelprozess-Hintergrundaufgaben verwendet werden.

Ein Beispiel, das zeigt, wie DeviceUseTrigger auf einem PC verwendet wird, finden Sie im Beispiel für benutzerdefinierte USB-Geräte. Ein Beispiel für ein Telefon finden Sie im Beispiel Für Hintergrundsensoren.

public ref class DeviceUseTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DeviceUseTrigger final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceUseTrigger final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DeviceUseTrigger
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceUseTrigger
function DeviceUseTrigger()
Public NotInheritable Class DeviceUseTrigger
Vererbung
Object Platform::Object IInspectable DeviceUseTrigger
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Weitere Informationen zu Richtlinienanforderungen finden Sie unter Zugreifen auf Sensoren und Geräte über eine Hintergrundaufgabe.

Bevor Ihre App eine Hintergrundaufgabe auf einem Telefon auslöst, muss sie zuerst BackgroundExecutionManager.RequestAccessAsync aufrufen, um zu überprüfen, ob die App eine Hintergrundaufgabe anfordern kann. Diese Überprüfung ist nicht erforderlich, wenn Ihre App auf einem PC ausgeführt wird.

Konstruktoren

DeviceUseTrigger()

Konstruktor für DeviceUseTrigger. Nimmt keine Parameter an.

Methoden

RequestAsync(String)

Löst die Hintergrundaufgabe aus und gibt ein DeviceTriggerResult zurück, das den Erfolg oder Fehler der Triggeranforderung angibt. Übernimmt die DeviceInformation.ID des Geräts oder Sensors, auf das die Hintergrundaufgabe zugreift.

RequestAsync(String, String)

Löst die Hintergrundaufgabe aus und gibt ein DeviceTriggerResult zurück, das den Erfolg oder Fehler der Triggeranforderung angibt. Übernimmt die DeviceInformation.ID des Geräts oder Sensors, auf das die Hintergrundaufgabe zugreift, und eine optionale App-spezifische Zeichenfolge, die an die Hintergrundaufgabe übergeben wird, um den auszuführenden Vorgang zu identifizieren.

Gilt für:

Weitere Informationen