UploadOperation.StartAsync メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

非同期アップロード操作を開始します。

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)

進行状況の更新を含む非同期アップロード操作。

メソッド呼び出しから機能固有の HRESULT が返されたときにスローされます。

これは、ネットワークメソッドによってスローされる最も一般的な例外です。アプリでは、例外の HRESULT を使用して、エラーの原因を特定する必要があります。

リソースや機能へのアクセスが拒否されるとスローされます。この例外は、要求されたネットワーク操作に必要なネットワーク機能がアプリマニフェストに設定されていない場合に発生します。

メソッドに提供された引数のいずれかが有効でない場合にスローされます。

ユーザーが指定した入力によってこの例外が発生した場合、アプリはユーザーに通知し、新しい入力を要求できます。

破棄されたオブジェクトで操作が実行されるとスローされます。

操作を完了するために使用できるメモリが不足している場合にスローされます。

アップロード操作は、StartAsync メソッドが呼び出される前に、BackgroundUploader.CreateUploader.CreateUploadAsync メソッド、または BackgroundUploader.CreateUploader.CreateUploadFromStreamAsync メソッドのいずれかを使用してスケジュールする必要があります。

重要

メイン UI スレッドで多数の転送をキューに登録すると、呼び出しが待機可能であっても、アプリの UI のパフォーマンスが低下する可能性があります。多数の転送をキューに入れている場合は、次の例のように、バックグラウンドワーカースレッドで StartAsync を呼び出することをお勧めします。

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