BackgroundTransferCompletionGroup Klasse

Referenz

Definition

Namespace:: Windows.Networking.BackgroundTransfer

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt eine Reihe von Hintergrundübertragungsvorgängen (DownloadOperation - oder UploadOperation-Objekte) dar, die eine Hintergrundaufgabe auslösen, sobald alle Vorgänge ausgeführt wurden (wenn die Vorgänge erfolgreich abgeschlossen wurden) oder mit einem Fehler fehlschlagen.

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

Vererbung: Object Platform::Object IInspectable BackgroundTransferCompletionGroup

Attribute: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die BackgroundTransferCompletionGroup-Klasse ermöglicht es einer App, sich zu registrieren, um sofortige Benachrichtigungen zu erhalten, nachdem Hintergrundübertragungsvorgänge abgeschlossen sind, auch wenn sich die App nicht im Vordergrund befindet. Die App registriert eine Hintergrundaufgabe, um eine Benachrichtigung zu erhalten, die auftritt, wenn die Hintergrundübertragungen erfolgreich abgeschlossen wurden oder wenn ein Fehler aufgetreten ist. Dadurch kann die App zum Zeitpunkt der Fertigstellung sofort benachrichtigt werden, anstatt zu verlangen, dass die App warten muss, bis die App das nächste Mal neu gestartet oder in den Vordergrund verschoben wird, um die Vervollständigung abzufragen.

Die App muss den IBackgroundTask implementieren, um auszuführen, der die Vervollständigungsbenachrichtigungen empfängt. Die IBackgroundTask muss mit der BackgroundTaskBuilder-Klasse registriert werden. Wenn BackgroundTransferCompletionGroup.Trigger zum Einrichten der Aufgabe verwendet wird, hebt die Brokerinfrastruktur die Registrierung automatisch auf, sobald sie ausgelöst wird, sodass kein expliziter Vorgangsentzugscode erforderlich ist.

Die Hintergrundaufgabe muss im App-Manifest deklariert werden. Die App erfordert keinen Sperrbildschirmzugriff, um eine BackgroundTransferCompletionGroup zu verwenden.

Konstruktoren

BackgroundTransferCompletionGroup()

Erstellt ein neues BackgroundTransferCompletionGroup-Objekt .

Eigenschaften

IsEnabled	Ruft einen Wert ab, der angibt, ob die Enable-Methode für eine BackgroundTransferCompletionGroup bereits aufgerufen wurde.
Trigger	Ruft den IBackgroundTrigger ab, der zum Einrichten der Hintergrundaufgabe verwendet wird, die der BackgroundTransferCompletionGroup zugeordnet ist.

Methoden

Enable()

Gibt an, dass die BackgroundTransferCompletionGroup abgeschlossen ist und keine weiteren Hintergrundübertragungsvorgänge (DownloadOperation - oder UploadOperation-Objekte ) zur Vervollständigungsgruppe hinzugefügt werden.

Gilt für:

Freigeben über