WebClient.DownloadDataTaskAsync メソッド

  • リファレンス

定義

名前空間:
System.Net
アセンブリ:
System.Net.WebClient.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。 これらのメソッドは、呼び出し元のスレッドをブロックしません。

オーバーロード

DownloadDataTaskAsync(String)

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。
DownloadDataTaskAsync(Uri)

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。

DownloadDataTaskAsync(String)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())

パラメーター

address
String

ダウンロードするリソースの URI。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、ダウンロードされたリソースを含む Byte 配列を返します。

属性
ComVisibleAttribute

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

リソースのダウンロード中にエラーが発生しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ リソースのダウンロード後に完了します。

このメソッドは、 パラメーターで指定された URI スキームに関連付けられているプロトコルの既定のメソッドを使用して、指定されたリソースを address 取得します。 データは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的にダウンロードされます。

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address追加されます。

この方法では、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合は、GET メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

次のコード例では、サーバーからデータを要求し、返されたデータを表示します。 には、 remoteUri 要求されたデータの有効な URI が含まれていることを前提としています。

適用対象

DownloadDataTaskAsync(Uri)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())

パラメーター

address
Uri

ダウンロードするリソースの URI。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、ダウンロードされたリソースを含む Byte 配列を返します。

属性
ComVisibleAttribute

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

リソースのダウンロード中にエラーが発生しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ リソースのダウンロード後に完了します。

このメソッドは、 パラメーターで指定された URI スキームに関連付けられているプロトコルの既定のメソッドを使用して、指定されたリソースを address 取得します。 データは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的にダウンロードされます。

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address追加されます。

この方法では、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合は、GET メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

適用対象