Condividi tramite


Windows.ApplicationModel.Background Spazio dei nomi

Consente a un'app di pianificare le attività in background per eseguire il codice dell'app anche quando l'app viene sospesa.

Le attività in background sono destinate a piccoli elementi di lavoro che non richiedono l'interazione utente o per la gestione delle azioni popup. Gli scenari appropriati per le attività in background includono il download di posta elettronica, la visualizzazione di una notifica popup per un messaggio di chat in ingresso o la reazione a una modifica in una condizione di sistema.

Vedere Supporto dell'app con attività in background ( usando JavaScript e HTML) o Supportare l'app con attività in background per indicazioni sull'implementazione di attività in background . Ad esempio, il codice che illustra come implementare attività in background, vedere l'esempio di attività in background.

Classi

ActivitySensorTrigger

Rappresenta un trigger attivato quando ActivitySensor riceve l'input. Questo viene usato quando l'applicazione deve rispondere al sensore di attività.

AlarmApplicationManager

Richiede l'autorizzazione dell'utente per impostare avvisi e recupera lo stato dell'autorizzazione utente per l'app per impostare gli avvisi.

AppBroadcastTrigger

Rappresenta un evento che attiva un'attività in background da eseguire quando un'applicazione avvia la trasmissione del gioco.

AppBroadcastTriggerProviderInfo

Fornisce informazioni sull'applicazione che trasmette il gioco, ad esempio il logo, il nome visualizzato e le caratteristiche video.

ApplicationTrigger

Ciò consente di attivare a livello di codice un'attività in background dall'interno dell'applicazione.

ApplicationTriggerDetails

Dettagli di un applicationTrigger.

AppointmentStoreNotificationTrigger

Rappresenta un trigger che avvia un'attività in background per l'elaborazione delle modifiche all'archivio appuntamenti.

BackgroundExecutionManager

Gestire l'autorizzazione per eseguire attività in background.

BackgroundTaskBuilder

Rappresenta un'attività in background da registrare con il sistema.

BackgroundTaskCompletedEventArgs

Rappresenta le informazioni di completamento per un'attività al momento dell'invio di una notifica di completamento.

BackgroundTaskDeferral

Rappresenta un rinvio dell'attività in background restituito dal metodo IBackgroundTaskInstance.GetDeferral .

BackgroundTaskProgressEventArgs

Rappresenta le informazioni sullo stato di avanzamento per un'attività al momento dell'invio di una notifica di aggiornamento dello stato.

BackgroundTaskRegistration

Rappresenta un'attività in background registrata con il sistema.

BackgroundTaskRegistrationGroup

Fornisce la semantica di raggruppamento in modo che la registrazione delle attività in background possa essere mantenuta separatamente.

BackgroundWorkCost

Recupera un suggerimento sulla disponibilità delle risorse per le attività in background. Le attività in background possono usare questo hint per decidere la quantità di lavoro da eseguire quando vengono attivate.

BluetoothLEAdvertisementPublisherTrigger

Rappresenta un trigger registrato per annunciare un annuncio Bluetooth LE in background.

BluetoothLEAdvertisementWatcherTrigger

Rappresenta un trigger registrato per l'analisi dell'annuncio Bluetooth LE in background.

CachedFileUpdaterTrigger

Rappresenta un trigger che avvia un'attività in background per abilitare il contratto Dell'aggiornamento file memorizzato nella cache.

CachedFileUpdaterTriggerDetails

Fornisce informazioni dettagliate sull'operazione di file memorizzata nella cache che ha richiamato il trigger.

ChatMessageNotificationTrigger

Rappresenta un trigger attivato quando è presente una notifica per un messaggio di testo.

ChatMessageReceivedNotificationTrigger

Rappresenta un trigger che avvia un'attività in background che gestisce qualsiasi messaggio in ingresso che potrebbe essere filtrato in base al relativo contenuto. Per altre informazioni sul filtro dei messaggi, vedere Windows.ApplicationModel.CommunicationBlocking.

CommunicationBlockingAppSetAsActiveTrigger

Rappresenta un trigger per attivare un'applicazione di blocco delle comunicazioni quando viene selezionata come app di blocco preferita.

Un utente può avere più applicazioni di blocco delle comunicazioni installate alla volta. Questo trigger viene usato per informare un'applicazione che è stata selezionata come applicazione di blocco delle comunicazioni attive. Per altre informazioni sull'API di blocco delle comunicazioni, vedere Windows.ApplicationModel.CommunicationBlocking.

ContactStoreNotificationTrigger

Rappresenta un trigger che avvia un'attività in background per l'elaborazione delle modifiche all'archivio contatti.

ContentPrefetchTrigger

Offre la possibilità di eseguire gestori personalizzati durante il pre-recupero delle risorse Web.

ConversationalAgentTrigger

Rappresenta un trigger che avvia un'attività in background per l'elaborazione della comunicazione digitale assistente tramite Il runtime di attivazione agente della piattaforma Windows (AAR).

CustomSystemEventTrigger

Questa classe consente di specificare un trigger di sistema personalizzato in modo che sia possibile registrarlo e rispondere quando viene attivato dal sistema.

DeviceConnectionChangeTrigger

Rappresenta un trigger che avvia un'attività in background quando lo stato della connessione di un dispositivo viene modificato.

DeviceManufacturerNotificationTrigger

Rappresenta un trigger che avvia un'attività in background per abilitare le operazioni del produttore del dispositivo.

DeviceServicingTrigger

Rappresenta un evento che un'applicazione può attivare per avviare un aggiornamento a esecuzione prolungata (firmware o impostazioni) di un dispositivo.

Windows 8.1 consente di sviluppare app UWP per i dispositivi periferici che comunicano tramite USB, HID e Bluetooth. Ad esempio, un utente potrebbe dover sincronizzare il contenuto in un PC o dal dispositivo oppure eseguire un aggiornamento a esecuzione prolungata al dispositivo stesso, ad esempio le impostazioni o gli aggiornamenti del firmware. Windows 8.1 fornisce due attività in background e le API corrispondenti che consentono al dispositivo di sincronizzare e aggiornare in background: DeviceServicingTrigger e DeviceUseTrigger. Questo argomento fornisce informazioni di riferimento sulle API per DeviceServicingTrigger: per informazioni sull'uso di questo trigger nel contesto di un'app per dispositivi, vedere Sincronizzazione del dispositivo e aggiornamento per le app per dispositivi UWP.

L'attività in background DeviceServicingTrigger consente all'app UWP che interagisce con il dispositivo periferico di eseguire aggiornamenti del dispositivo a esecuzione prolungata mentre l'app viene sospesa, ad esempio i trasferimenti di impostazioni o gli aggiornamenti del firmware. L'aggiornamento del dispositivo in background richiede l'approvazione dell'utente ogni volta che viene usata l'attività in background. A differenza dell'attività in background DeviceUseTrigger , l'attività in background DeviceServicingTrigger consente il riavvio e la disconnessione del dispositivo e consente un massimo di 30 minuti di attività in background.

Importante

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

DeviceUseTrigger

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 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, vedere l'esempio di dispositivo USB personalizzato. Per un esempio di telefono, vedere l'esempio Di sensori in background.

DeviceWatcherTrigger

Rappresenta un evento che causa l'esecuzione di un'attività in background quando si verificano modifiche all'elenco di dispositivi. Restituito da GetBackgroundTrigger.

EmailStoreNotificationTrigger

Rappresenta un trigger che abilita la notifica delle modifiche all'archivio di posta elettronica.

GattCharacteristicNotificationTrigger

Rappresenta un trigger che avvia un'attività in background quando viene ricevuta una notifica di modifica in ingresso per una caratteristica Bluetooth LE GATT.

GattServiceProviderTrigger

Costruisce un servizio Generic Attributes (GATT) che può essere mantenuto in background.

GattServiceProviderTriggerResult

Questa classe contiene il trigger creato da GattServiceProviderTrigger.CreateAsync().

GeovisitTrigger

Rappresenta un evento che attiva un'attività in background relativa alle visite.

LocationTrigger

Rappresenta un evento di posizione che attiva un'attività in background. Questo viene usato per geofencing.

MaintenanceTrigger

Rappresenta un trigger di manutenzione.

MediaProcessingTrigger

Rappresenta un trigger che avvia un'attività in background per eseguire l'elaborazione multimediale.

MobileBroadbandDeviceServiceNotificationTrigger

Rappresenta un trigger che attiva quando la rete invia comandi dello strumento SIM. Le app che ricevono questa notifica elaborano quindi i comandi dello strumento SIM.

Questa funzionalità è disponibile solo per le app degli operatori mobili e l'app UWP data l'accesso con privilegi dagli operatori di rete mobile. Per altre informazioni, vedere Banda larga mobile.

MobileBroadbandPcoDataChangeTrigger

Rappresenta un evento di modifica dell'opzione di configurazione del protocollo cellulare che attiva un'attività in background da eseguire.

MobileBroadbandPinLockStateChangeTrigger

Rappresenta un trigger che indica quando lo stato di blocco del PIN SIM è cambiato.

Questa funzionalità è disponibile solo per le app degli operatori mobili e l'app UWP data l'accesso con privilegi dagli operatori di rete mobile. Per altre informazioni, vedere Banda larga mobile.

MobileBroadbandRadioStateChangeTrigger

Rappresenta un trigger che indica quando lo stato della radio a banda larga mobile è cambiato. Ad esempio, questo trigger viene attivato quando un dispositivo mobile passa a o dalla modalità aereo.

Questa funzionalità è disponibile solo per le app degli operatori mobili e l'app UWP data l'accesso con privilegi dagli operatori di rete mobile. Per altre informazioni, vedere Banda larga mobile.

MobileBroadbandRegistrationStateChangeTrigger

Rappresenta un trigger che indica quando lo stato di registrazione a banda larga mobile è cambiato. Ad esempio, questo trigger viene attivato quando un dispositivo mobile passa a o da Roaming.

Questa funzionalità è disponibile solo per le app degli operatori mobili e l'app UWP data l'accesso con privilegi dagli operatori di rete mobile. Per altre informazioni, vedere Banda larga mobile.

NetworkOperatorDataUsageTrigger

Rappresenta un trigger che avvia un'attività in background quando i contatori dati locali stimano che l'utilizzo (byte inviati e ricevuti) nell'interfaccia a banda larga mobile è cambiato da una soglia attivabile.

Nota

Questa funzionalità è disponibile solo per le app degli operatori mobili e le app UWP date l'accesso con privilegi dagli operatori di rete mobile.

Se si vuole usare questa API e pubblicare l'app in Microsoft Store, sarà necessaria un'approvazione speciale. Per altre informazioni, vedere la sezione Funzionalità limitate nell'argomento Dichiarazioni di funzionalità app e Banda larga mobile.

NetworkOperatorHotspotAuthenticationTrigger

Rappresenta un trigger di autenticazione hotspot dell'operatore di rete mobile.

Nota

Un'app può creare un'istanza di questo oggetto e registrare l'evento di autenticazione hotspot dopo che è stato effettuato il provisioning di un profilo WLAN che fa riferimento a questa app per gestire l'autenticazione hotspot. Per altre informazioni, vedere Integrazione di Windows 8 per gli operatori hotspot wireless.

NetworkOperatorNotificationTrigger

Rappresenta un trigger di notifica dell'operatore di rete mobile.

PaymentAppCanMakePaymentTrigger

Questa classe rappresenta un trigger PaymentAppCanMakePayment.

PhoneTrigger

Rappresenta un evento telefonico che attiva un'attività in background.

PushNotificationTrigger

Rappresenta un oggetto che richiama un elemento di lavoro in background nell'app in risposta alla ricezione di una notifica non elaborata.

RcsEndUserMessageAvailableTrigger

Rappresenta un trigger che avvia un'attività in background quando è disponibile un nuovo messaggio RICH Communication Services (RCS).

RfcommConnectionTrigger

Rappresenta un trigger che avvia un'attività in background quando vengono stabilite connessioni in ingresso o in uscita RFCOMM.

SecondaryAuthenticationFactorAuthenticationTrigger

Rappresenta un trigger che avvia un'attività in background per conto di un dispositivo complementare.

SensorDataThresholdTrigger

Rappresenta un trigger che risponde quando viene superato un limite di soglia per un sensore.

SmartCardTrigger

Rappresenta un evento attivato da una smart card.

SmsMessageReceivedTrigger

Rappresenta un trigger generato quando è arrivato un messaggio SMS.

SocketActivityTrigger

Rappresenta un trigger che avvia un'attività in background per la gestione dell'attività socket.

StorageLibraryChangeTrackerTrigger

Rappresenta una modifica del file all'interno di Un oggetto StorageFolder che attiva un'attività in background da eseguire.

StorageLibraryContentChangedTrigger

Crea un trigger che verrà generato quando un file viene modificato in una libreria specificata.

SystemCondition

Rappresenta una condizione di sistema che deve essere effettiva per l'esecuzione di un'attività in background.

SystemTrigger

Rappresenta un evento di sistema che attiva un'attività in background da eseguire.

TetheringEntitlementCheckTrigger

Rappresenta un evento di tethering che attiva un'attività in background da eseguire.

TimeTrigger

Rappresenta un evento temporale che attiva un'attività in background da eseguire.

ToastNotificationActionTrigger

Rappresenta un evento che causa l'esecuzione di un'attività in background quando l'utente esegue un'azione su una notifica popup interattiva.

ToastNotificationHistoryChangedTrigger

Rappresenta un evento che causa l'esecuzione di un'attività in background quando la cronologia delle notifiche di tipo avviso popup per l'app viene cancellata, quando una o più notifiche di tipo avviso popup vengono aggiunte o rimosse dalla cronologia delle notifiche per l'app o quando una o più notifiche di tipo avviso popup per l'app scadono e vengono rimosse dalla cronologia delle notifiche.

UserNotificationChangedTrigger

Rappresenta un trigger che viene generato quando viene aggiunto o rimosso un oggetto UserNotification .

WiFiOnDemandHotspotConnectTrigger

Rappresenta un evento che causa l'esecuzione di un'attività in background quando l'utente desidera connettersi a una rete hotspot specifica su richiesta.

Il codice attività in background deve eseguire il cast del valore della proprietà IBackgroundTaskInstance.TriggerDetails su WiFiOnDemandHotspotConnectTriggerDetails.

Nota

Se si vuole usare questa API in un'app UWP e pubblicare l'app in Microsoft Store, sarà necessario richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre informazioni, vedere Funzionalità personalizzate.

La funzionalità Di rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari di hotspot end-to-Wi-Fi end tra un dispositivo hardware compatibile con tethering e un PC Windows.

WiFiOnDemandHotspotUpdateMetadataTrigger

Rappresenta un evento che causa l'esecuzione di un'attività in background quando l'utente apre l'elenco di rete del sistema operativo Wi-Fi, come se connettersi a una nuova rete Wi-Fi.

Nota

Se si vuole usare questa API in un'app UWP e pubblicare l'app in Microsoft Store, sarà necessario richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre informazioni, vedere Funzionalità personalizzate.

La funzionalità Di rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari di hotspot end-to-Wi-Fi end tra un dispositivo hardware compatibile con tethering e un PC Windows.

Interfacce

IBackgroundCondition

Utilizzato per applicare il tipo di oggetto condizione di sistema.

IBackgroundTask

Fornisce un metodo per eseguire il lavoro di un'attività in background.

IBackgroundTaskInstance

Fornisce l'accesso a un'istanza dell'attività in background.

IBackgroundTaskInstance2

Fornisce l'accesso a un'istanza dell'attività in background. Eredita dall'interfaccia IBackgroundTaskInstance e aggiunge il metodo GetThrottleCount .

IBackgroundTaskInstance4

Fornisce l'accesso a un'istanza di attività in background, incluse informazioni sull'utente.

IBackgroundTaskRegistration

Fornisce l'accesso a un'attività in background registrata.

IBackgroundTaskRegistration2

Fornisce l'accesso a un'attività in background registrata. Eredita dall'interfaccia IBackgroundTaskRegistration e aggiunge la proprietà Trigger .

IBackgroundTaskRegistration3

Rappresenta un'attività in background registrata come parte di un gruppo di attività in background correlate.

IBackgroundTrigger

Rappresenta l'interfaccia di base per gli eventi trigger.

Enumerazioni

AlarmAccessStatus

Indica se l'utente ha concesso l'autorizzazione per l'app per impostare gli avvisi.

ApplicationTriggerResult

Risultato della richiesta per attivare un'attività in background. Il metodo RequestAsync restituisce un valore di questo tipo di enumerazione.

BackgroundAccessRequestKind

Specifica il livello di attività in background che un'app può richiedere.

BackgroundAccessStatus

Questa enumerazione specifica la capacità di un'app di eseguire attività in background.

Le app devono chiamare correttamente BackgroundExecutionManager.RequestAccessAsync prima di registrare le attività in background.

BackgroundTaskCancellationReason

Specifica i motivi per l'annullamento di un'attività in background.

BackgroundTaskThrottleCounter

Indica il tipo di conteggio delle limitazioni da controllare in una richiesta GetThrottleCount .

BackgroundWorkCostValue

Indica il costo corrente dell'esecuzione del lavoro in background. Usato come hint per le attività in background sulla quantità di lavoro che possono eseguire.

CustomSystemEventTriggerRecurrence

Specifica quando un CustomSystemEventTrigger può essere attivato.

DeviceTriggerResult

Indica se l'operazione dell'attività in background del dispositivo è stata consentita o negata e se è stata negata specifica il motivo.

EnergyUseLevel

Consente a un'app di pianificare le attività in background per eseguire il codice dell'app anche quando l'app viene sospesa.

Le attività in background sono destinate a piccoli elementi di lavoro che non richiedono l'interazione utente o per la gestione delle azioni popup. Gli scenari appropriati per le attività in background includono il download di posta elettronica, la visualizzazione di una notifica popup per un messaggio di chat in ingresso o la reazione a una modifica in una condizione di sistema.

Vedere Supporto dell'app con attività in background ( usando JavaScript e HTML) o Supportare l'app con attività in background per indicazioni sull'implementazione di attività in background . Ad esempio, il codice che illustra come implementare attività in background, vedere l'esempio di attività in background.

LocationTriggerType

Indica un tipo di evento di posizione per un trigger attività in background della posizione.

MediaProcessingTriggerResult

Specifica il risultato di una chiamata a MediaProcessingTrigger.RequestAsync.

SystemConditionType

Specifica una condizione di sistema che deve essere effettiva per l'esecuzione di un'attività in background. Se viene attivata un'attività in background con una condizione di sistema, l'attività non verrà eseguita finché non viene soddisfatta la condizione.

SystemTriggerType

Specifica gli eventi di sistema che possono essere usati per attivare un'attività in background.

Delegati

BackgroundTaskCanceledEventHandler

Rappresenta un metodo che gestisce l'annullamento di un'attività in background.

BackgroundTaskCompletedEventHandler

Rappresenta un metodo che gestisce gli eventi di completamento per un'attività in background.

BackgroundTaskProgressEventHandler

Rappresenta un metodo che gestisce gli eventi di aggiornamento dello stato per un'attività in background.

Vedi anche