BackgroundTransferCompletionGroup Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Networking.BackgroundTransfer

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

Rappresenta un set di operazioni di trasferimento in background (oggetti DownloadOperation o UploadOperation ) che attivano un'attività in background dopo che tutte le operazioni vengono eseguite (se le operazioni sono state completate correttamente) o hanno esito negativo con un errore.

public ref class BackgroundTransferCompletionGroup 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 BackgroundTransferCompletionGroup 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 BackgroundTransferCompletionGroup 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 BackgroundTransferCompletionGroup

[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 BackgroundTransferCompletionGroup

function BackgroundTransferCompletionGroup()

Public NotInheritable Class BackgroundTransferCompletionGroup

Ereditarietà: Object Platform::Object IInspectable BackgroundTransferCompletionGroup

Attributi: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

La classe BackgroundTransferCompletionGroup consente a un'app di registrarsi per ricevere una notifica immediata dopo il completamento delle operazioni di trasferimento in background anche se l'app non è in primo piano. L'app registra un'attività in background per ricevere una notifica che si verifica se i trasferimenti in background sono stati completati correttamente o se si è verificato un errore. Ciò consente all'app di ricevere immediatamente una notifica al momento del completamento, invece di richiedere che l'app attenda fino alla successiva riavvio dell'app o spostata in primo piano per eseguire una query per i completamenti.

L'app deve implementare IBackgroundTask per l'esecuzione che riceve le notifiche di completamento. IBackgroundTask deve essere registrato usando la classe BackgroundTaskBuilder. Quando BackgroundTransferCompletionGroup.Trigger viene usato per configurare l'attività, l'infrastruttura broker annulla automaticamente la registrazione non appena viene attivata, quindi non è necessario disporre di codice esplicito di annullamento della registrazione dell'attività.

L'attività in background deve essere dichiarata nel manifesto dell'app. L'app non richiede l'accesso alla schermata di blocco per usare backgroundTransferCompletionGroup.

Costruttori

BackgroundTransferCompletionGroup()

Crea un nuovo oggetto BackgroundTransferCompletionGroup .

Proprietà

IsEnabled	Ottiene un valore che indica se il metodo Enable in un oggetto BackgroundTransferCompletionGroup è già stato chiamato.
Trigger	Ottiene l'oggetto IBackgroundTrigger utilizzato per configurare l'attività in background associata a BackgroundTransferCompletionGroup.

Metodi

Enable()

Indica che BackgroundTransferCompletionGroup è completo e non verranno aggiunte altre operazioni di trasferimento in background (oggetti DownloadOperation o UploadOperation ) al gruppo di completamento.

Si applica a

Condividi tramite