次の方法で共有

WebClient.OpenReadAsync メソッド

  • リファレンス

定義

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

指定したリソースを格納している読み取り可能なストリームを開きます。 これらのメソッドは、呼び出し元のスレッドをブロックしません。

オーバーロード

OpenReadAsync(Uri)

指定したリソースを格納している読み取り可能なストリームを開きます。 このメソッドは、呼び出し元のスレッドをブロックしません。
OpenReadAsync(Uri, Object)

指定したリソースを格納している読み取り可能なストリームを開きます。 このメソッドは、呼び出し元のスレッドをブロックしません。

OpenReadAsync(Uri)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

指定したリソースを格納している読み取り可能なストリームを開きます。 このメソッドは、呼び出し元のスレッドをブロックしません。

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

パラメーター

address
Uri

取得するリソースの URI。

例外

ArgumentNullException

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

WebException

BaseAddress とアドレスを組み合わせて形成された URI が無効です。

- または -

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

- または -

ストリームのオープン中にエラーが発生しました。

注釈

このメソッドは、 パラメーターで Stream 指定されたリソースへのアクセスに使用されるインスタンスを address 取得します。 ストリームは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して取得されます。 ストリームが使用可能になったときに通知を受信するには、 イベントにイベント ハンドラーを OpenReadCompleted 追加します。

注意

が終了Streamしたら、 を呼び出Stream.Closeして、システム リソースが不足しないようにする必要があります。

このメソッドは、ストリームが開いている間、呼び出し元のスレッドをブロックしません。 ストリームの待機中にブロックするには、 メソッドを OpenReadAsync 使用します。

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

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を指定しない場合は、 address と組み合わせて BaseAddress 、要求されたリソースの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString でない null場合は、 に address追加されます。

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

Note

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって OpenRead(Uri)スローされる例外に関するページを参照してください。

適用対象

OpenReadAsync(Uri, Object)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

指定したリソースを格納している読み取り可能なストリームを開きます。 このメソッドは、呼び出し元のスレッドをブロックしません。

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。

userToken
Object

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

例外

ArgumentNullException

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

WebException

BaseAddress とアドレスを組み合わせて形成された URI が無効です。

- または -

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

- または -

ストリームのオープン中にエラーが発生しました。

注釈

このメソッドは、 パラメーターで Stream 指定されたリソースへのアクセスに使用されるインスタンスを address 取得します。 ストリームは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して取得されます。 ストリームが使用可能になったときに通知を受信するには、 イベントにイベント ハンドラーを OpenReadCompleted 追加します。

注意

が終了Streamしたら、 を呼び出Stream.Closeして、システム リソースが不足しないようにする必要があります。

このメソッドは、ストリームが開いている間、呼び出し元のスレッドをブロックしません。 ストリームの待機中にブロックするには、 メソッドを OpenRead 使用します。

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

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を指定しない場合は、 address と組み合わせて BaseAddress 、要求されたリソースの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString でない null場合は、 に address追加されます。

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

Note

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

適用対象