HttpContent.ReadAsStreamAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

串行化 HTTP 內容，並傳回代表內容的數據流。

多載

ReadAsStreamAsync()	串行化 HTTP 內容，並傳回以異步操作表示內容的數據流。
ReadAsStreamAsync(CancellationToken)	串行化 HTTP 內容，並傳回以異步操作表示內容的數據流。

備註

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

ReadAsStreamAsync()

來源:

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)

來源:

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> 物件會在讀取所有代表內容的數據流之後完成（除非已實作 CreateContentReadStream(CancellationToken) 否則為 。 例如，使用 HttpClient時，例如 SendAsync 的方法會傳回衍生自 HttpContent 的類別，該類別會根據針對 completionOption 參數傳遞的內容，有條件地緩衝。

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

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