BackgroundTransferGroup.CreateGroup(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.