HttpClient.GetStreamAsync メソッド

  • リファレンス

定義

名前空間:
System.Net.Http
アセンブリ:
System.Net.Http.dll
アセンブリ:
netstandard.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
ソース:
HttpClient.cs
ソース:
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> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

適用対象

GetStreamAsync(String, CancellationToken)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
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> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

適用対象

GetStreamAsync(Uri)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
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);
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> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

適用対象

GetStreamAsync(String)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
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);
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> オブジェクトは、応答ヘッダーの読み取り後に完了します。 このメソッドは、応答本文の読み取りとバッファー処理を行いません。

注意

タイムアウトの場合:

適用対象