BackgroundTransferCompletionGroup Klasse

Definition

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

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:

Weitere Informationen