UploadOperation.StartAsync 方法

定義

啟動非同步上傳作業。

public:
 virtual IAsyncOperationWithProgress<UploadOperation ^, UploadOperation ^> ^ StartAsync() = StartAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<UploadOperation, UploadOperation const&> StartAsync();
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<UploadOperation,UploadOperation> StartAsync();
function startAsync()
Public Function StartAsync () As IAsyncOperationWithProgress(Of UploadOperation, UploadOperation)

傳回

包含進度更新的非同步上傳作業。

屬性

備註

例外狀況

COMException

從方法呼叫傳回功能特定的 HRESULT 時擲回。

這是網路方法擲回的最常見例外狀況。 應用程式應該使用例外狀況中的 HRESULT 來判斷錯誤的原因。

AccessDeniedException

在存取資源或功能遭拒時擲回。 當應用程式在要求之網路作業的應用程式資訊清單中未設定必要的網路功能時,就會發生此例外狀況。

InvalidArgumentException

在其中一個提供給方法的引數無效時擲回。

如果使用者提供的輸入造成此例外狀況,應用程式可能會通知使用者並要求新的輸入。

ObjectDisposedException

在已處置的物件上執行作業時擲回。

OutOfMemoryException

當記憶體不足而無法完成作業時擲回。

必須先使用其中一個BackgroundUploader.CreateUpload、BackgroundUploader.CreateUploadAsyncBackgroundUploader.CreateUploader.CreateUploadFromStreamAsync方法來排程上傳作業,然後再呼叫 StartAsync 方法。

重要

在主要 UI 執行緒上排入大量傳輸,可能會導致應用程式的 UI 效能降低,即使呼叫是可等候的。 如果您要排入大量傳輸佇列,建議您在背景背景背景工作執行緒上呼叫 StartAsync ,如下列範例所示。

operation = await Task.Run(() => { return myUploadOperation.StartAsync(); });

適用於

另請參閱