WebClient.DownloadDataAsync メソッド

  • リファレンス

定義

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

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

オーバーロード

DownloadDataAsync(Uri)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。
DownloadDataAsync(Uri, Object)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。

DownloadDataAsync(Uri)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。

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

パラメーター

address
Uri

ダウンロードする URI を格納している Uri。

例外

ArgumentNullException

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

WebException

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

  • または -

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

注釈

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

このメソッドは、リソースのダウンロード中に呼び出し元のスレッドをブロックしません。 サーバーの応答を待機している間にリソースをダウンロードしてブロックするには、いずれかの方法を DownloadData 使用します。 ダウンロードが完了すると、イベントが発生します DownloadDataCompleted 。 通知を受信するには、アプリケーションでこのイベントを処理する必要があります。 ダウンロードしたデータは、プロパティで Result 使用できます。

.NET Framework および .NET Core 1.0 では、メソッドを呼び出すことによって完了していない非同期操作をCancelAsync取り消すことができます。

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

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

注意

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

適用対象

DownloadDataAsync(Uri, Object)

非同期操作として指定された URI からByte 配列としてリソースをダウンロードします。

public:
 void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadDataAsync (Uri address, 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 を格納している Uri。

userToken
Object

非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義のオブジェクト。

例外

ArgumentNullException

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

WebException

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

  • または -

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

注釈

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

このメソッドは、リソースのダウンロード中に呼び出し元のスレッドをブロックしません。 サーバーの応答を待機している間にリソースをダウンロードしてブロックするには、いずれかの方法を DownloadData 使用します。 ダウンロードが完了すると、イベントが発生します DownloadDataCompleted 。 通知を受信するには、アプリケーションでこのイベントを処理する必要があります。 ダウンロードしたデータは、プロパティで Result 使用できます。

.NET Framework および .NET Core 1.0 では、メソッドを呼び出すことによって完了していない非同期操作をCancelAsync取り消すことができます。

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

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

注意

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

適用対象