Windows.ApplicationModel.Background Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.
|
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
- Esempio di attività in background (Windows 10)
- Esempio di esecuzione estesa (Windows 10)
- Esempio di dispositivo USB personalizzato (Windows 10)
- Esempio di blocco e filtro delle comunicazioni
- Esempio di attivazione in background
- Esempio DatagramSocket
- Esempio StreamSocket
- Esempio di codice adattivo versione