BackgroundTransferGroup.CreateGroup(String) メソッド

定義

指定されたグループ名を使用して転送グループを作成します。

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 オブジェクトは、アプリ セッションにまたがる転送操作をサポートするために保持できます。 以前のアプリ セッションで作成されたグループへのアクセスを簡略化するために、 BackgroundDownloaderBackgroundUploaderDownloadOperationUploadOperation に新しいメソッドが導入されました。

Note

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

適用対象