HttpClient.GetStreamAsync メソッド

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

オーバーロード

GetStreamAsync(Uri, CancellationToken)	指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。
GetStreamAsync(String, CancellationToken)	指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。
GetStreamAsync(Uri)	指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。
GetStreamAsync(String)	指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

注釈

操作はブロックされません。

GetStreamAsync(Uri, CancellationToken)

ソース:

HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Stream)

パラメーター

requestUri

Uri

要求の送信先 URI。

cancellationToken

CancellationToken

操作をキャンセルするキャンセル トークン。

戻り値

Task<Stream>

非同期操作を表すタスク オブジェクト。

例外

ArgumentNullException

requestUri が null です。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

TaskCanceledException

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この操作はブロックされません。 返された Task<Stream> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

• .NET Frameworkは をHttpRequestExceptionスローします。
• .NET Core は、内部例外なしで を TaskCanceledException スローします。
• .NET 5 以降のバージョンでは、 を TaskCanceledException 入れ子 TimeoutExceptionにする がスローされます。

GetStreamAsync(String, CancellationToken)

ソース:

HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Stream)

パラメーター

requestUri

String

要求の送信先 URI。

cancellationToken

CancellationToken

操作をキャンセルするキャンセル トークン。

戻り値

Task<Stream>

非同期操作を表すタスク オブジェクト。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この操作はブロックされません。 返された Task<Stream> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

• .NET Frameworkは をHttpRequestExceptionスローします。
• .NET Core は、内部例外なしで を TaskCanceledException スローします。
• .NET 5 以降のバージョンでは、 を TaskCanceledException 入れ子 TimeoutExceptionにする がスローされます。

GetStreamAsync(Uri)

ソース:

HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri);

member this.GetStreamAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri) As Task(Of Stream)

パラメーター

requestUri

Uri

要求の送信先 URI。

戻り値

Task<Stream>

非同期操作を表すタスク オブジェクト。

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

TaskCanceledException

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

注釈

この操作はブロックされません。 返された Task<Stream> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

• .NET Frameworkは をHttpRequestExceptionスローします。
• .NET Core は、内部例外なしで を TaskCanceledException スローします。
• .NET 5 以降のバージョンでは、 を TaskCanceledException 入れ子 TimeoutExceptionにする がスローされます。

GetStreamAsync(String)

ソース:

HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri);

member this.GetStreamAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String) As Task(Of Stream)

パラメーター

requestUri

String

要求の送信先 URI。

戻り値

Task<Stream>

非同期操作を表すタスク オブジェクト。

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

TaskCanceledException

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

UriFormatException

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

注釈

この操作はブロックされません。 返された Task<Stream> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

• .NET Frameworkは をHttpRequestExceptionスローします。
• .NET Core は、内部例外なしで を TaskCanceledException スローします。
• .NET 5 以降のバージョンでは、 を TaskCanceledException 入れ子 TimeoutExceptionにする がスローされます。