DownloadOperation.AttachAsync Método

Definição

Namespace:

Windows.Networking.BackgroundTransfer

Retorna uma operação assíncrona que pode ser usada para monitorar o progresso e a conclusão do download anexado. Chamar esse método permite que um aplicativo anexe operações de download iniciadas em uma instância anterior do aplicativo.

public:
 virtual IAsyncOperationWithProgress<DownloadOperation ^, DownloadOperation ^> ^ AttachAsync() = AttachAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DownloadOperation, DownloadOperation const&> AttachAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DownloadOperation,DownloadOperation> AttachAsync();

function attachAsync()

Public Function AttachAsync () As IAsyncOperationWithProgress(Of DownloadOperation, DownloadOperation)

Retornos

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

Baixe a operação com retorno de chamada.

Atributos

RemoteAsyncAttribute

Exemplos

function AttachDownload (loadedDownload) {
    try {
        download = loadedDownload;
        promise = download.attachAsync().then(complete, error, progress);
    } catch (err) {
        displayException(err);
    }
};

Comentários

Exceções

COMException

Gerado quando um HRESULT específico do recurso é retornado de uma chamada de método.

Essa é a exceção mais comum gerada pelos métodos de rede. Um aplicativo deve usar o HRESULT da exceção para determinar a causa do erro.

AccessDeniedException

Gerada quando o acesso a um recurso é negado. Essa exceção ocorre quando um aplicativo não tem os recursos de rede necessários definidos no manifesto do aplicativo para a operação de rede solicitada.

InvalidArgumentException

Gerada quando um dos argumentos fornecidos a um método não é válido.

Se a entrada fornecida pelo usuário causou essa exceção, um aplicativo poderá informar o usuário e solicitar uma nova entrada.

ObjectDisposedException

Gerada quando uma operação é executada em um objeto descartado.

OutOfMemoryException

Gerado quando a memória insuficiente está disponível para concluir a operação.

Embora esse método possa ser chamado de várias instâncias de aplicativo, os desenvolvedores não devem anexar retornos de chamada da instância do aplicativo primário em uma tarefa em segundo plano. Isso fará com queBackgroundTransferHost.exe travam.