HttpContent.ReadAsStreamAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

將 HTTP 內容序列化，並傳回代表內容的資料流。

多載

ReadAsStreamAsync()	以非同步作業方式將 HTTP 內容序列化，並傳回代表內容的資料流。
ReadAsStreamAsync(CancellationToken)	以非同步作業方式將 HTTP 內容序列化，並傳回代表內容的資料流。

備註

請注意，除非已實作否則，此方法會在內部緩衝內容 CreateContentReadStreamAsync() 。

ReadAsStreamAsync()

Source:

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<Stream>

工作物件，表示非同步作業。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在讀取代表內容的所有資料流程之後完成。

作業完成後， Result 傳回的工作物件上的 屬性會包含代表 HTTP 內容的資料流程。 傳回的資料流程接著可以使用各種資料流程 API 來讀取內容。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 ReadAsStream() 擲回的例外狀況。

ReadAsStreamAsync(CancellationToken)

Source:

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<Stream>

工作物件，表示非同步作業。

例外狀況

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在讀取代表內容的所有資料流程之後完成。

作業完成後， Result 傳回的工作物件上的 屬性會包含代表 HTTP 內容的資料流程。 傳回的資料流程接著可以使用各種資料流程 API 來讀取內容。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 ReadAsStream() 擲回的例外狀況。