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 に新しいメソッドが導入されました。

Note

Windows 8.1と Windows Server 2012 R2 では、システム全体に対して最大 50 個の一意の転送グループがサポートされています。 そのため、アプリは、アプリによって作成されたすべての転送グループに対して、一意の ID または少数の一意の ID を再利用する必要があります。 システムに 50 を超える転送グループが作成された場合、アプリは回復不能な状態になります。