BackgroundTransferGroup.CreateGroup(String) Methode
Definition
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.
Erstellt eine Übertragungsgruppe unter Verwendung des angegebenen Gruppennamens.
public:
static BackgroundTransferGroup ^ CreateGroup(Platform::String ^ name); static BackgroundTransferGroup CreateGroup(winrt::hstring const& name);public static BackgroundTransferGroup CreateGroup(string name);function createGroup(name)Public Shared Function CreateGroup (name As String) As BackgroundTransferGroupParameter
- name
-
String
Platform::String
winrt::hstring
Der Name der Gruppe. Wenn bereits eine Gruppe mit diesem Namen vorhanden ist, gibt diese Methode einen Verweis auf das vorhandene Gruppenobjekt zurück.
Gibt zurück
Die neue BackgroundTransferGroup.
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
Windows 8.1 und Windows Server 2012 R2 unterstützen maximal 50 eindeutige Übertragungsgruppen für das gesamte System. Daher sollte eine App eine eindeutige ID oder eine kleine Anzahl eindeutiger IDs für alle von der App erstellten Übertragungsgruppen wiederverwenden. Wenn mehr als 50 Übertragungsgruppen auf dem System erstellt werden, wird die App in einem nicht wiederherstellbaren Zustand angezeigt.