DownloadOperation.AttachAsync 方法

定义

命名空间:

Windows.Networking.BackgroundTransfer

返回可用于监视附加下载进度和完成情况的异步操作。 调用此方法可让应用附加在以前的应用实例中启动的下载操作。

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)

返回

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

使用回调执行下载操作。

属性

RemoteAsyncAttribute

示例

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

注解

例外

COMException

从方法调用返回特定于功能的 HRESULT 时引发。

这是网络方法引发的最常见异常。 应用应使用异常中的 HRESULT 来确定错误原因。

AccessDeniedException

被拒绝访问资源或功能时引发。 如果应用未在应用清单中为请求的网络操作设置所需的网络功能，则会发生此异常。

InvalidArgumentException

当提供给方法的参数之一无效时引发。

如果用户提供的输入导致此异常，应用可以通知用户并请求新输入。

ObjectDisposedException

对已释放对象执行操作时引发。

OutOfMemoryException

当内存不足以完成操作时引发。

虽然可以从多个应用实例调用此方法，但开发人员不应在后台任务中附加主应用实例的回调。 这将导致 BackgroundTransferHost.exe 挂起。