WebClient.DownloadDataAsync メソッド

定義

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

オーバーロード

DownloadDataAsync(Uri)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

DownloadDataAsync(Uri, Object)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

DownloadDataAsync(Uri)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

public:
 void DownloadDataAsync(Uri ^ address);
public void DownloadDataAsync (Uri address);
member this.DownloadDataAsync : Uri -> unit
Public Sub DownloadDataAsync (address As Uri)

パラメーター

address
Uri

ダウンロードする URI を格納している UriA Uri containing the URI to download.

例外

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.

注釈

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

このメソッドは、リソースのダウンロード中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while downloading the resource. サーバーの応答を待機している間にリソースとブロックをダウンロードするには、@no__t 0 のメソッドのいずれかを使用します。To download a resource and block while waiting for the server's response, use one of the DownloadData methods. ダウンロードが完了すると、@no__t 0 イベントが発生します。When the download completes, the DownloadDataCompleted event is raised. 通知を受信するには、アプリケーションでこのイベントを処理する必要があります。Your application must handle this event to receive notification. ダウンロードしたデータは、Result プロパティで使用できます。The downloaded data is available in the Result property.

@No__t-0 メソッドを使用して、完了していない非同期操作を取り消すことができます。You can use the CancelAsync method to cancel asynchronous operations that have not completed.

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

@No__t 0 のプロパティが空の文字列 ("") ではなく、address に絶対 URI が含まれていない場合、address は、要求されたデータの絶対 URI を形成するために BaseAddress と組み合わせた相対 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. @No__t 0 のプロパティが空の文字列でない場合は、address に追加されます。If the QueryString property is not an empty string, it is appended to address.

注意

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

DownloadDataAsync(Uri, Object)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

public:
 void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadDataAsync (Uri address, object userToken);
member this.DownloadDataAsync : Uri * obj -> unit
Public Sub DownloadDataAsync (address As Uri, userToken As Object)

パラメーター

address
Uri

ダウンロードする URI を格納している UriA Uri containing the URI to download.

userToken
Object

非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義のオブジェクト。A user-defined object that is passed to the method invoked when the asynchronous operation completes.

例外

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.

注釈

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

このメソッドは、リソースのダウンロード中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while downloading the resource. サーバーの応答を待機している間にリソースとブロックをダウンロードするには、@no__t 0 のメソッドのいずれかを使用します。To download a resource and block while waiting for the server's response, use one of the DownloadData methods. ダウンロードが完了すると、@no__t 0 イベントが発生します。When the download completes, the DownloadDataCompleted event is raised. 通知を受信するには、アプリケーションでこのイベントを処理する必要があります。Your application must handle this event to receive notification. ダウンロードしたデータは、Result プロパティで使用できます。The downloaded data is available in the Result property.

@No__t-0 メソッドを使用して、完了していない非同期操作を取り消すことができます。You can use the CancelAsync method to cancel asynchronous operations that have not completed.

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

@No__t 0 のプロパティが空の文字列 ("") ではなく、address に絶対 URI が含まれていない場合、address は、要求されたデータの絶対 URI を形成するために BaseAddress と組み合わせた相対 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. @No__t 0 のプロパティが空の文字列でない場合は、address に追加されます。If the QueryString property is not an empty string, it is appended to address.

注意

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

適用対象