WebClient.OpenReadAsync メソッド

定義

指定したリソースを格納している読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

OpenReadAsync(Uri)

指定したリソースを格納している読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

OpenReadAsync(Uri, Object)

指定したリソースを格納している読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

OpenReadAsync(Uri)

指定したリソースを格納している読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

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

パラメーター

address
Uri

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

例外

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.

注釈

このメソッドは、 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. ストリームが使用可能になったときに通知を受け取るには、イベントにイベントハンドラーを追加し OpenReadCompleted ます。To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

注意

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

このメソッドは、ストリームのオープン中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is opening. ストリームの待機中にブロックするには、メソッドを使用し OpenReadAsync ます。To block while waiting for the stream, use the OpenReadAsync method.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") ではなく、絶対 uri も指定されていない場合 address 、は、 address 要求された BaseAddress リソースの絶対 uri を形成するためにと組み合わせられる相対 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 .NET Framework.

適用対象

OpenReadAsync(Uri, Object)

指定したリソースを格納している読み取り可能なストリームを開きます。Opens a readable stream containing the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

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

パラメーター

address
Uri

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

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 とアドレスを組み合わせて形成された 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.

注釈

このメソッドは、 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. ストリームが使用可能になったときに通知を受け取るには、イベントにイベントハンドラーを追加し OpenReadCompleted ます。To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

注意

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

このメソッドは、ストリームのオープン中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is opening. ストリームの待機中にブロックするには、メソッドを使用し OpenRead ます。To block while waiting for the stream, use the OpenRead method.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") ではなく、絶対 uri も指定されていない場合 address 、は、 address 要求された BaseAddress リソースの絶対 uri を形成するためにと組み合わせられる相対 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 .NET Framework.

適用対象