Condividi tramite

Windows.Networking.BackgroundTransfer Spazio dei nomi

  • Riferimento
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.

Vedi anche