BackgroundTransferGroup Klasse

Definition

Namespace:

Windows.Networking.BackgroundTransfer

Eine benannte Gruppe, die verwendet wird, um mehrere Download- oder Uploadvorgänge zuzuordnen. Diese Klasse erleichtert Es Ihrer App, diese Gruppen zu erstellen und Downloads und Uploads gleichzeitig, in seriell oder basierend auf der Priorität durchzuführen.

Wenn sich ein Benutzer beispielsweise entscheidet, Episoden aus einer beliebten Fernsehserie herunterzuladen und zu watch, kann Ihre App die frühesten Episoden in der Serie priorisieren oder dem Benutzer die Auswahl überlassen, welche Episode zuerst heruntergeladen werden soll.

public ref class BackgroundTransferGroup sealed

/// [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 BackgroundTransferGroup final

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

Public NotInheritable Class BackgroundTransferGroup

Vererbung

Object Platform::Object IInspectable BackgroundTransferGroup

Attribute

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

Ein BackgroundTransferGroup-Objekt kann beibehalten werden, um Übertragungsvorgänge zu unterstützen, die App-Sitzungen umfassen. Es wurden neue Methoden in BackgroundDownloader, BackgroundUploader, DownloadOperation und UploadOperation eingeführt, um den Zugriff auf Gruppen zu vereinfachen, die in einer vorherigen App-Sitzung erstellt wurden.

Hinweis

Pro App werden bis zu 50 eindeutige Übertragungsgruppen unterstützt.

Eigenschaften

Name	Ruft den Namen der Gruppe ab.
TransferBehavior	Ruft die Eigenschaft ab, mit der angegeben wird, ob Übertragungen innerhalb dieser Gruppe gleichzeitig oder in seriell ausgeführt werden, oder legt sie fest. Mögliche Werte werden von BackgroundTransferBehavior definiert.

Methoden

CreateGroup(String)

Erstellt eine Übertragungsgruppe unter Verwendung des angegebenen Gruppennamens.