WebClient.DownloadStringTaskAsync WebClient.DownloadStringTaskAsync WebClient.DownloadStringTaskAsync WebClient.DownloadStringTaskAsync Method

定義

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

オーバーロード

DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String)

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

DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri)

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

DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String)

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

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

パラメーター

address
String String String String

ダウンロードするリソースの URI。The URI of the resource to download.

戻り値

非同期操作を表すタスク オブジェクト。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. リソースは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的にダウンロードされます。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.

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

プロパティが空の文字列 ("" address ) ではなく、絶対 uri も含まれていaddressない場合、は、要求されたBaseAddressデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。 BaseAddressIf 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. プロパティが空の文字列でない場合は、にaddress追加されます。 QueryStringIf 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.

DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri)

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

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

パラメーター

address
Uri Uri Uri Uri

ダウンロードするリソースの URI。The URI of the resource to download.

戻り値

非同期操作を表すタスク オブジェクト。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. リソースは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的にダウンロードされます。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.

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

プロパティが空の文字列 ("" address ) ではなく、絶対 uri も含まれていaddressない場合、は、要求されたBaseAddressデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。 BaseAddressIf 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. プロパティが空の文字列でない場合は、にaddress追加されます。 QueryStringIf 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.

適用対象