WebClient.DownloadStringAsync WebClient.DownloadStringAsync WebClient.DownloadStringAsync WebClient.DownloadStringAsync Method

定義

String または Uri として指定したリソースをダウンロードします。Downloads the resource specified as a String or a Uri. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri)

Uri として指定したリソースをダウンロードします。Downloads the resource specified as a Uri. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object)

指定したリソースに指定した文字列をダウンロードします。Downloads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri)

Uri として指定したリソースをダウンロードします。Downloads the resource specified as a Uri. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

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

パラメーター

address
Uri Uri Uri 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.

注釈

リソースは、スレッド プールから自動的に割り当てられているスレッド リソースを使用して非同期にダウンロードされます。The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

このメソッドがで指定されたエンコーディングを使用、リソースをダウンロードした後、Encodingをリソースに変換するプロパティ、Stringします。After downloading the resource, this method uses the encoding specified in the Encoding property to convert the resource to a String. このメソッドは、リソースのダウンロード中に呼び出し元のスレッドをブロックしません。This method does not block the calling thread while downloading the resource. リソースとブロックをダウンロードするには、サーバーの応答の待機中に、使用、DownloadStringメソッド。To download a resource and block while waiting for the server's response, use the DownloadString method. ダウンロードが完了したら、DownloadStringCompletedイベントが発生します。When the download completes, the DownloadStringCompleted event is raised. アプリケーションでは、通知を受信するには、このイベントを処理する必要があります。Your application must handle this event to receive notification. ダウンロードした文字列が表示されます、Resultプロパティ。The downloaded string is available in the Result property.

使用することができます、CancelAsyncメソッドを完了していない非同期操作をキャンセルします。You can use the CancelAsync method to cancel asynchronous operations that have not completed.

場合、BaseAddressプロパティは空の文字列ではありません ("") と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. 場合、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 the .NET Framework.

DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object)

指定したリソースに指定した文字列をダウンロードします。Downloads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

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

パラメーター

address
Uri Uri Uri Uri

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

userToken
Object Object Object 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.

注釈

リソースは、スレッド プールから自動的に割り当てられているスレッド リソースを使用して非同期にダウンロードされます。The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

このメソッドがで指定されたエンコーディングを使用、リソースをダウンロードした後、Encodingをリソースに変換するプロパティ、Stringします。After downloading the resource, this method uses the encoding specified in the Encoding property to convert the resource to a String. このメソッドは、リソースのダウンロード中に呼び出し元のスレッドをブロックしません。This method does not block the calling thread while downloading the resource. リソースとブロックをダウンロードするには、サーバーの応答の待機中に、使用、DownloadStringメソッド。To download a resource and block while waiting for the server's response, use the DownloadString method. ダウンロードが完了したら、DownloadStringCompletedイベントが発生します。When the download completes, the DownloadStringCompleted event is raised. アプリケーションでは、通知を受信するには、このイベントを処理する必要があります。Your application must handle this event to receive notification. ダウンロードした文字列が表示されます、Resultプロパティ。The downloaded string is available in the Result property.

使用することができます、CancelAsyncメソッドを完了していない非同期操作をキャンセルします。You can use the CancelAsync method to cancel asynchronous operations that have not completed.

場合、BaseAddressプロパティは空の文字列ではありません ("") と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. 場合、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 the .NET Framework.

適用対象