HttpContent.ReadAsStreamAsync 方法

定义

命名空间:

System.Net.Http

程序集:

netstandard.dll, System.Net.Http.dll

序列化 HTTP 内容并返回表示内容的流。

重载

ReadAsStreamAsync()	序列化 HTTP 内容并返回将内容表示为异步操作的流。
ReadAsStreamAsync(CancellationToken)	序列化 HTTP 内容并返回将内容表示为异步操作的流。

注解

请注意，除非已实现 CreateContentReadStreamAsync() 否则，此方法将内部缓冲内容。

ReadAsStreamAsync()

Source:

HttpContent.cs

序列化 HTTP 内容并返回将内容表示为异步操作的流。

C#

public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync();

返回

Task<Stream>

表示异步操作的任务对象。

注解

此操作不会阻止。 返回的 Task<TResult> 对象将在读取表示内容的所有流后完成。

操作完成后，返回的任务对象的 Result 属性包含表示 HTTP 内容的流。 然后，可以使用返回的流来使用各种流 API 读取内容。

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 ReadAsStream()引发的异常。

ReadAsStreamAsync(CancellationToken)

Source:

HttpContent.cs

序列化 HTTP 内容并返回将内容表示为异步操作的流。

C#

public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync(System.Threading.CancellationToken cancellationToken);

参数

cancellationToken

CancellationToken

取消操作的取消令牌。

返回

Task<Stream>

表示异步操作的任务对象。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此操作不会阻止。 返回的 Task<TResult> 对象将在读取所有表示内容的流后完成（除非已实现 CreateContentReadStream(CancellationToken) 以其他方式执行）。 例如，使用 HttpClient时，SendAsync 等方法返回派生自 HttpContent 的类，该类根据 completionOption 参数传递的内容有条件地缓冲。

操作完成后，返回的任务对象的 Result 属性包含表示 HTTP 内容的流。 然后，可以使用返回的流来使用各种流 API 读取内容。

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 ReadAsStream()引发的异常。