次の方法で共有


DownloadOperation.AttachAsync メソッド

定義

アタッチされたダウンロードの進行状況と完了を監視するために使用できる非同期操作を返します。 このメソッドを呼び出すと、アプリは、前のアプリ インスタンスで開始されたダウンロード操作をアタッチできます。

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)

戻り値

コールバックを使用したダウンロード操作。

属性

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 がハングします。

適用対象