DownloadOperation.AttachAsync 方法

參考

定義

命名空間:: Windows.Networking.BackgroundTransfer

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

傳回非同步作業，可用來監視附加下載的進度和完成。呼叫這個方法可讓應用程式附加先前應用程式實例中啟動的下載作業。

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 停止回應。

適用於

共用方式為