Windows.Networking.BackgroundTransfer Spazio dei nomi

Riferimento

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.

Modifica

Abilita funzionalità di download e caricamento avanzate all'interno di un'app. Per una panoramica delle funzionalità di trasferimento in background, vedere Trasferimento dei dati in background. Scaricare l'esempio di trasferimento in background per un esempio di codice.

Nota

Il trasferimento in background è progettato principalmente per le operazioni di trasferimento a lungo termine per risorse come video, musica e immagini di grandi dimensioni. Per le operazioni a breve termine che coinvolgono i trasferimenti di risorse più piccole (ad esempio un paio di KB), le API HTTP sono consigliate. HttpClient è preferito e può essere usato in tutte le lingue supportate dalle app UWP. XHR può essere usato in JavaScript. IXHR2 può essere usato in C++.

Classi

BackgroundDownloader	Usato per configurare i download prima della creazione effettiva dell'operazione di download usando CreateDownload. Per una panoramica delle funzionalità di trasferimento in background, vedere Trasferimento dei dati in background. Scaricare l'esempio di trasferimento in background per un esempio di codice. Nota Il trasferimento in background è progettato principalmente per le operazioni di trasferimento a lungo termine per risorse come video, musica e immagini di grandi dimensioni. Per le operazioni a breve termine che coinvolgono i trasferimenti di risorse più piccole (ad esempio un paio di KB), usare lo spazio dei nomi Windows.Web.Http .
BackgroundTransferCompletionGroup	Rappresenta un set di operazioni di trasferimento in background (oggetti DownloadOperation o UploadOperation) che attivano un'attività in background una volta eseguite tutte le operazioni (se le operazioni sono state completate correttamente) o hanno esito negativo con un errore.
BackgroundTransferCompletionGroupTriggerDetails	Contiene informazioni su backgroundTransferCompletionGroup a cui è possibile accedere solo dal metodo Run in IBackgroundTask.
BackgroundTransferContentPart	Rappresenta una parte del contenuto di una richiesta di trasferimento a più parti. Ogni oggetto BackgroundTransferContentPart può rappresentare una singola stringa di contenuto di testo o un singolo payload di file, ma non entrambi.
BackgroundTransferError	Usato per fornire errori rilevati durante un'operazione di trasferimento.
BackgroundTransferGroup	Un gruppo denominato usato per associare più operazioni di download o caricamento. Questa classe semplifica la creazione di questi gruppi e il completamento di download e caricamenti simultanei, in serie o in base alla priorità. Ad esempio, se un utente decide di scaricare e watch episodi da una serie televisiva popolare, l'app può assegnare priorità ai primi episodi della serie o consentire all'utente di scegliere quale episodio scaricare per primo.
BackgroundTransferRangesDownloadedEventArgs	Fornisce l'accesso alle informazioni sull'evento di avanzamento del download incrementale.
BackgroundUploader	Usato per configurare il caricamento prima della creazione effettiva dell'operazione di caricamento usando CreateUpload. Per una panoramica delle funzionalità di trasferimento in background, vedere Trasferimento dei dati in background. Scaricare l'esempio di trasferimento in background per un esempio di codice. Nota Il trasferimento in background è progettato principalmente per le operazioni di trasferimento a lungo termine per risorse come video, musica e immagini di grandi dimensioni. Per le operazioni a breve termine che coinvolgono i trasferimenti di risorse più piccole (ad esempio un paio di KB), usare lo spazio dei nomi Windows.Web.Http .
ContentPrefetcher	Fornisce le proprietà per specificare le risorse Web da pre-recuperare. Windows userà euristica per tentare di scaricare le risorse specificate in anticipo dell'app avviata dall'utente.
DownloadOperation	Esegue un'operazione di download asincrona. L'esempio di trasferimento in background illustra questa funzionalità. Per una panoramica delle funzionalità di trasferimento in background, vedere Trasferimento dei dati in background.
ResponseInformation	Rappresenta i dati restituiti da una risposta del server.
UnconstrainedTransferRequestResult	Rappresenta il risultato di una richiesta per i trasferimenti non vincolati da un oggetto BackgroundDownloader o BackgroundUploader . Le operazioni di trasferimento senza vincoli possono essere eseguite senza restrizioni di risorse normalmente associate alle operazioni di rete in background mentre un dispositivo in esecuzione sulla batteria.
UploadOperation	Esegue un'operazione di caricamento asincrona. Per una panoramica delle funzionalità di trasferimento in background, vedere Trasferimento dei dati in background. Scaricare l'esempio di trasferimento in background per un esempio di codice.

Struct

BackgroundDownloadProgress	Contiene informazioni sullo stato sull'operazione di download.
BackgroundTransferFileRange	Contiene informazioni sullo stato sull'operazione di trasferimento file.
BackgroundUploadProgress	Contiene informazioni sullo stato sull'operazione di caricamento.

Interfacce

IBackgroundTransferBase	Rappresenta un'operazione di trasferimento in background.
IBackgroundTransferContentPartFactory	Crea un oggetto BackgroundTransferContentPart .
IBackgroundTransferOperation	Rappresenta un'operazione di trasferimento in background.
IBackgroundTransferOperationPriority	Usare questa interfaccia per determinare la priorità di un download o caricamento in backgroundTransferGroup. I valori possibili sono definiti dall'enumerazione BackgroundTransferPriority .

Enumerazioni

BackgroundTransferBehavior	Definisce i valori usati per indicare se i download e i caricamenti all'interno di un'esecuzione di BackgroundTransferGroup vengono eseguiti contemporaneamente o in serie.
BackgroundTransferCostPolicy	Definisce i valori usati per specificare se i trasferimenti possono verificarsi in reti a consumo.
BackgroundTransferPriority	Indica la priorità che un'operazione BackgroundTransfer(download o caricamento) ha in termini di pianificazione all'interno di un'app.
BackgroundTransferStatus	Definisce i valori di stato dell'operazione di trasferimento.

Commenti

Nella maggior parte delle piattaforme, Il trasferimento in background continuerà a trasferire i file (download o caricamento) anche quando l'app viene sospesa o quando termina. Quando l'app viene avviata, è necessario chiamare BackgroundDownloader.GetCurrentDownloadsAsync o BackgroundUploader.GetCurrentUploadsAsync per enumerare tutti i trasferimenti incompleti. Chiamare quindi DownloadOperation.AttachAsync o UploadOperation.AttachAsync, rispettivamente, su ognuno di essi. In questo modo, recupera lo stato più recente del trasferimento e causa la ripresa dei trasferimenti dopo un riavvio del sistema. Quando DownloadOperation.IsRandomAccessRequired è true, il download riprende automaticamente dopo un riavvio. È consigliabile chiamare AttachAsync anche in questo caso. Se l'app viene eseguita al termine dei trasferimenti, ovvero quando la chiamata a AttachAsync restituisce, è possibile eseguire operazioni in risposta. In alternativa, è possibile usare BackgroundTransferCompletionGroup per avviare un'attività in background al termine dei trasferimenti.

In Xbox, Il trasferimento in background trasferisce solo i file (download o caricamento) mentre l'app è in primo piano. Quando un'app viene sospesa, inserita in background o chiusa, i trasferimenti in background dell'app vengono sospesi. Quando l'app viene eseguita di nuovo in primo piano, i trasferimenti vengono ripresi automaticamente.