HttpContent.ReadAsStreamAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
HTTP コンテンツをシリアル化し、コンテンツを表すストリームを返します。
オーバーロード
| ReadAsStreamAsync() |
HTTP コンテンツをシリアル化し、コンテンツを非同期操作として表すストリームを返します。 |
| ReadAsStreamAsync(CancellationToken) |
HTTP コンテンツをシリアル化し、コンテンツを非同期操作として表すストリームを返します。 |
注釈
このメソッドは、他の方法で実装 CreateContentReadStreamAsync() 場合を除き、コンテンツを内部的にバッファー処理します。
ReadAsStreamAsync()
- ソース:
- HttpContent.cs
- ソース:
- HttpContent.cs
- ソース:
- HttpContent.cs
HTTP コンテンツをシリアル化し、コンテンツを非同期操作として表すストリームを返します。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync();public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync ();member this.ReadAsStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>Public Function ReadAsStreamAsync () As Task(Of Stream)戻り値
非同期操作を表すタスク オブジェクト。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、コンテンツを表すストリームがすべて読み取られた後に完了します。
操作が完了すると、返されたタスク オブジェクトの Result プロパティには、HTTP コンテンツを表すストリームが含まれます。 返されたストリームを使用して、さまざまなストリーム API を使用してコンテンツを読み取ることができます。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentExceptionなどの使用例外は、引き続き同期的にスローされます。 格納されている例外については、ReadAsStream()によってスローされる例外を参照してください。
適用対象
ReadAsStreamAsync(CancellationToken)
- ソース:
- HttpContent.cs
- ソース:
- HttpContent.cs
- ソース:
- HttpContent.cs
HTTP コンテンツをシリアル化し、コンテンツを非同期操作として表すストリームを返します。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync (System.Threading.CancellationToken cancellationToken);member this.ReadAsStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>Public Function ReadAsStreamAsync (cancellationToken As CancellationToken) As Task(Of Stream)パラメーター
- cancellationToken
- CancellationToken
操作を取り消すキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、コンテンツを表すストリームがすべて読み取られた後に完了します (それ以外の場合 CreateContentReadStream(CancellationToken) 実装されていない場合)。
たとえば、HttpClientを使用する場合、SendAsync などのメソッドは、completionOption パラメーターに渡された内容に基づいて条件付きでバッファーする HttpContent から派生したクラスを返します。
操作が完了すると、返されたタスク オブジェクトの Result プロパティには、HTTP コンテンツを表すストリームが含まれます。 返されたストリームを使用して、さまざまなストリーム API を使用してコンテンツを読み取ることができます。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentExceptionなどの使用例外は、引き続き同期的にスローされます。 格納されている例外については、ReadAsStream()によってスローされる例外を参照してください。
適用対象
.NET