Compartilhar via


BackgroundTransferGroup.CreateGroup(String) Método

Definição

Cria um grupo de transferência usando o nome do grupo fornecido.

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

Parâmetros

name
String

Platform::String

winrt::hstring

O nome do grupo. Se já existir um grupo com esse nome, esse método retornará uma referência ao objeto de grupo existente.

Retornos

O novo BackgroundTransferGroup.

Comentários

Um objeto BackgroundTransferGroup pode persistir para dar suporte a operações de transferência que abrangem sessões de aplicativo. Novos métodos foram introduzidos em BackgroundDownloader, BackgroundUploader, DownloadOperation e UploadOperation para simplificar o acesso a grupos criados em uma sessão de aplicativo anterior.

Observação

Windows 8.1 e Windows Server 2012 R2 dão suporte a no máximo 50 grupos de transferência exclusivos para todo o sistema. Portanto, um aplicativo deve reutilizar uma ID exclusiva ou um pequeno número de IDs exclusivas para todos os grupos de transferência criados pelo aplicativo. Se mais de 50 grupos de transferência forem criados no sistema, o aplicativo ficará em um estado irrecuperável.

Aplica-se a