BackgroundTransferGroup.CreateGroup(String) 方法

定義

命名空間:

Windows.Networking.BackgroundTransfer

使用提供的組名建立傳輸群組。

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 BackgroundTransferGroup

參數

name

String

Platform::String

winrt::hstring

群組的名稱。 如果已有這個名稱的群組存在，這個方法會傳回現有群組物件的參考。

傳回

BackgroundTransferGroup

新的 BackgroundTransferGroup。

備註

BackgroundTransferGroup物件可以保存，以支援跨越應用程式會話的傳輸作業。 新的方法已導入BackgroundDownloader、BackgroundUploader、DownloadOperation 和 UploadOperation，以簡化在先前應用程式會話中建立的存取群組。

注意

Windows 8.1和 Windows Server 2012 R2 最多支援整個系統的 50 個唯一傳輸群組。 因此，應用程式應該針對應用程式所建立的所有傳輸群組重複使用唯一識別碼或少量的唯一識別碼。 如果在系統上建立超過 50 個傳輸群組，應用程式將會處於無法復原的狀態。