HttpContent.CreateContentReadStreamAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

多載

CreateContentReadStreamAsync()	以非同步作業方式將 HTTP 內容序列化為記憶體資料流。
CreateContentReadStreamAsync(CancellationToken)	以非同步作業方式將 HTTP 內容序列化為記憶體資料流。

CreateContentReadStreamAsync()

來源:

HttpContent.cs

以非同步作業方式將 HTTP 內容序列化為記憶體資料流。

protected:
 virtual System::Threading::Tasks::Task<System::IO::Stream ^> ^ CreateContentReadStreamAsync();

protected virtual System.Threading.Tasks.Task<System.IO.Stream> CreateContentReadStreamAsync ();

abstract member CreateContentReadStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>
override this.CreateContentReadStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>

Protected Overridable Function CreateContentReadStreamAsync () As Task(Of Stream)

傳回

Task<Stream>

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

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在所有內容都已寫入記憶體數據流之後完成。

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

方法 CreateContentReadStreamAsync 會將內容緩衝至記憶體數據流。 如果有更好的方式可將內容擷取為數據流，衍生類別可以覆寫此行為。 例如，位元組陣列或字串可以使用更有效率的方法，例如將唯讀 MemoryStream 包裝在位元組或字串周圍。

CreateContentReadStreamAsync(CancellationToken)

來源:

HttpContent.cs

以非同步作業方式將 HTTP 內容序列化為記憶體資料流。

protected:
 virtual System::Threading::Tasks::Task<System::IO::Stream ^> ^ CreateContentReadStreamAsync(System::Threading::CancellationToken cancellationToken);

protected virtual System.Threading.Tasks.Task<System.IO.Stream> CreateContentReadStreamAsync (System.Threading.CancellationToken cancellationToken);

abstract member CreateContentReadStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>
override this.CreateContentReadStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Protected Overridable Function CreateContentReadStreamAsync (cancellationToken As CancellationToken) As Task(Of Stream)

參數

cancellationToken

CancellationToken

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

傳回

Task<Stream>

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

例外狀況

OperationCanceledException

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

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在所有內容都已寫入記憶體數據流之後完成。

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

方法 CreateContentReadStreamAsync 會將內容緩衝至記憶體數據流。 如果有更好的方式可將內容擷取為數據流，衍生類別可以覆寫此行為。 例如，位元組陣列或字串可以使用更有效率的方法，例如將唯讀 MemoryStream 包裝在位元組或 string。)