WebClient.DownloadDataTaskAsync メソッド

定義

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

DownloadDataTaskAsync(String)

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

DownloadDataTaskAsync(Uri)

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

DownloadDataTaskAsync(String)

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

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。The URI of the resource to download.

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティは、ダウンロードされたリソースを含む Byte 配列を返します。The Result property on the task object returns a Byte array containing the downloaded resource.

属性

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

- または --or-

リソースのダウンロード中にエラーが発生しました。An error occurred while downloading the resource.

注釈

この操作はブロックされません。This operation will not block. 返された Task<TResult> オブジェクトは、データリソースがダウンロードされた後に完了します。The returned Task<TResult> object will complete after the data resource has been downloaded.

このメソッドは、パラメーターで指定された URI スキームに関連付けられているプロトコルの既定のメソッドを使用して、指定されたリソースを取得し address ます。This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in the address parameter. スレッドプールから自動的に割り当てられたスレッドリソースを使用して、データが非同期的にダウンロードされます。The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

このメソッドは、RETR コマンドを使用して FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースの場合は、GET メソッドが使用されます。For an HTTP resource, the GET method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

次のコード例では、サーバーからデータを要求し、返されたデータを表示します。The following code example requests data from a server and displays the data returned. これは、に remoteUri 要求されたデータの有効な URI が含まれていることを前提としています。It assumes that remoteUri contains a valid URI for the requested data.

適用対象

DownloadDataTaskAsync(Uri)

タスク オブジェクトを使用した非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

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。The URI of the resource to download.

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティは、ダウンロードされたリソースを含む Byte 配列を返します。The Result property on the task object returns a Byte array containing the downloaded resource.

属性

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

- または --or-

リソースのダウンロード中にエラーが発生しました。An error occurred while downloading the resource.

注釈

この操作はブロックされません。This operation will not block. 返された Task<TResult> オブジェクトは、データリソースがダウンロードされた後に完了します。The returned Task<TResult> object will complete after the data resource has been downloaded.

このメソッドは、パラメーターで指定された URI スキームに関連付けられているプロトコルの既定のメソッドを使用して、指定されたリソースを取得し address ます。This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in the address parameter. スレッドプールから自動的に割り当てられたスレッドリソースを使用して、データが非同期的にダウンロードされます。The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

このメソッドは、RETR コマンドを使用して FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースの場合は、GET メソッドが使用されます。For an HTTP resource, the GET method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象