WebClient.OpenReadAsync メソッド

ソース:

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

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

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

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

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

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

ソース:

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

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

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

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

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