WebClient.OpenReadTaskAsync WebClient.OpenReadTaskAsync WebClient.OpenReadTaskAsync WebClient.OpenReadTaskAsync Method

定義

タスク オブジェクトを使用した非同期操作として指定されたリソースを含む読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource as an asynchronous operation using a task object. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String)

タスク オブジェクトを使用した非同期操作として指定されたリソースを含む読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri)

タスク オブジェクトを使用した非同期操作として指定されたリソースを含む読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String)

タスク オブジェクトを使用した非同期操作として指定されたリソースを含む読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

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

パラメーター

address
String String String String

取得するリソースの URI。The URI of the resource to retrieve.

戻り値

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティは、リソースからのデータの読み取りに使用される Stream を返します。The Result property on the task object returns a Stream used to read data from a resource.

例外

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

BaseAddress とアドレスを組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

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

または-or- ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

注釈

この操作はブロックされません。This operation will not block. 返されたTask<TResult>オブジェクトは、完了した後、データ リソースに読み取り可能なストリームが開かれています。The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. このメソッドは、ストリームを開くときに、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is opening.

このメソッドは、取得、Streamで指定されたリソースへのアクセスに使用されるインスタンス、addressパラメーター。This method retrieves a Stream instance used to access the resource specified by the address parameter. ストリームは、スレッド プールから自動的に割り当てられているスレッド リソースを使用して取得されます。The stream is obtained using thread resources that are automatically allocated from the thread pool.

注意

呼び出す必要がありますStream.Close使用が終了したら、Streamシステム リソースの不足を回避します。You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

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

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI で指定されていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたリソースの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested resource. 場合、QueryStringプロパティはnullに追加されますaddressします。If the QueryString property is not null, 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.

こちらもご覧ください

OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri)

タスク オブジェクトを使用した非同期操作として指定されたリソースを含む読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

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

パラメーター

address
Uri Uri Uri Uri

取得するリソースの URI。The URI of the resource to retrieve.

戻り値

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティは、リソースからのデータの読み取りに使用される Stream を返します。The Result property on the task object returns a Stream used to read data from a resource.

例外

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

BaseAddress とアドレスを組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

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

または-or- ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

注釈

この操作はブロックされません。This operation will not block. 返されたTask<TResult>オブジェクトは、完了した後、データ リソースに読み取り可能なストリームが開かれています。The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. このメソッドは、ストリームを開くときに、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is opening.

このメソッドは、取得、Streamで指定されたリソースへのアクセスに使用されるインスタンス、addressパラメーター。This method retrieves a Stream instance used to access the resource specified by the address parameter. ストリームは、スレッド プールから自動的に割り当てられているスレッド リソースを使用して取得されます。The stream is obtained using thread resources that are automatically allocated from the thread pool.

注意

呼び出す必要がありますStream.Close使用が終了したら、Streamシステム リソースの不足を回避します。You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

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

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI で指定されていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたリソースの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested resource. 場合、QueryStringプロパティはnullに追加されますaddressします。If the QueryString property is not null, 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.

こちらもご覧ください

適用対象