Condividi tramite


DeviceUseTrigger Classe

Definizione

Rappresenta un evento che un'app Windows Runtime può attivare per avviare un'operazione a esecuzione prolungata con un dispositivo o un sensore.

DeviceUseTrigger consente all'app di Windows Runtime di accedere ai sensori e ai dispositivi periferici in background, anche quando l'app in primo piano è sospesa. Ad esempio, a seconda della posizione in cui l'app viene eseguita, potrebbe usare un'attività in background per sincronizzare i dati con i dispositivi o con i sensori di monitoraggio.

Questa classe può essere usata nell'app UWP e Windows Phone'app 8.x. Tuttavia, un'attività in background DeviceUseTrigger supporta API diverse ed è soggetta a criteri diversi, a seconda della posizione in cui è in esecuzione (PC o telefono). Per altre informazioni su queste differenze, vedere Accesso a sensori e dispositivi da un'attività in background.

Importante

Questo trigger non può essere usato con attività in background a processo singolo.

Per un esempio che mostra come usare DeviceUseTrigger in un PC, vedi l'esempio di dispositivo USB personalizzato. Per un esempio di telefono, vedi l'esempio di sensori in background.

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
Ereditarietà
Object Platform::Object IInspectable DeviceUseTrigger
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per altre informazioni sui requisiti dei criteri, vedere Accesso a sensori e dispositivi da un'attività in background

Prima che l'app attivi un'attività in background su un telefono, deve prima chiamare BackgroundExecutionManager.RequestAccessAsync per verificare se l'app è in grado di richiedere un'attività in background. Questo controllo non è obbligatorio quando l'app è in esecuzione in un PC.

Costruttori

DeviceUseTrigger()

Costruttore per DeviceUseTrigger. Non accetta parametri.

Metodi

RequestAsync(String)

Attiva l'attività in background e restituisce un valore DeviceTriggerResult che indica l'esito positivo o negativo della richiesta di trigger. Accetta il DeviceInformation.ID del dispositivo o del sensore a cui accederà l'attività in background.

RequestAsync(String, String)

Attiva l'attività in background e restituisce un valore DeviceTriggerResult che indica l'esito positivo o negativo della richiesta di trigger. Accetta il DeviceInformation.ID del dispositivo o del sensore a cui accederà l'attività in background e una stringa facoltativa specifica dell'app passata all'attività in background che identifica l'operazione da eseguire.

Si applica a

Vedi anche