HttpContent.CreateContentReadStream(CancellationToken) 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

來源:

HttpContent.cs

將 HTTP 內容序列化為記憶體資料流程。

protected:
 virtual System::IO::Stream ^ CreateContentReadStream(System::Threading::CancellationToken cancellationToken);

protected virtual System.IO.Stream CreateContentReadStream (System.Threading.CancellationToken cancellationToken);

abstract member CreateContentReadStream : System.Threading.CancellationToken -> System.IO.Stream
override this.CreateContentReadStream : System.Threading.CancellationToken -> System.IO.Stream

Protected Overridable Function CreateContentReadStream (cancellationToken As CancellationToken) As Stream

參數

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Stream

包含序列化 HTTP 內容的輸出記憶體資料流程。

例外狀況

OperationCanceledException

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

作業完成後，傳回的記憶體資料流程代表 HTTP 內容。 傳回的資料流程接著可用來使用各種串流 API 來讀取內容。 方法 CreateContentReadStream(CancellationToken) 會將內容緩衝至記憶體資料流程。 如果有更好的方式可將內容擷取為數據流，衍生類別可以覆寫此行為。 例如，位元組陣列或字串可以使用更有效率的方法，例如將唯讀 MemoryStream 包裝在位元組或字串周圍。