HttpContent.ReadAsStreamAsync Yöntem

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kod:

System.Net.Http.dll

HTTP içeriğini seri hale getirir ve içeriği temsil eden bir akış döndürür.

Aşırı Yüklemeler

ReadAsStreamAsync()	HTTP içeriğini seri hale getirme ve içeriği zaman uyumsuz bir işlem olarak temsil eden bir akış döndürme.
ReadAsStreamAsync(CancellationToken)	HTTP içeriğini seri hale getirme ve içeriği zaman uyumsuz bir işlem olarak temsil eden bir akış döndürme.

Açıklamalar

Aksini yapmak için CreateContentReadStreamAsync() uygulanmadığı sürece bu yöntemin içeriği dahili olarak arabelleğe alınacağını unutmayın.

ReadAsStreamAsync()

Kaynak:

HttpContent.cs

HTTP içeriğini seri hale getirme ve içeriği zaman uyumsuz bir işlem olarak temsil eden bir akış döndürme.

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)

Döndürülenler

Task<Stream>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Açıklamalar

Bu işlem engellenmez. döndürülen Task<TResult> nesnesi, içeriği temsil eden tüm akış okunduktan sonra tamamlanır.

İşlem tamamlandıktan sonra, döndürülen görev nesnesinde Result özelliği HTTP içeriğini temsil eden akışı içerir. Döndürülen akış daha sonra çeşitli akış API'leri kullanılarak içeriği okumak için kullanılabilir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, ReadAsStream()tarafından oluşan özel durumlara bakın.

ReadAsStreamAsync(CancellationToken)

Kaynak:

HttpContent.cs

HTTP içeriğini seri hale getirme ve içeriği zaman uyumsuz bir işlem olarak temsil eden bir akış döndürme.

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)

Parametreler

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<Stream>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellenmez. döndürülen Task<TResult> nesnesi, içeriği temsil eden tüm akış okunduktan sonra tamamlanır (aksini yapmak için CreateContentReadStream(CancellationToken) uygulanmadığı sürece). Örneğin, HttpClientkullanırken, SendAsync gibi bir yöntem, completionOption parametresi için geçirilenleri temel alarak koşullu olarak arabelleğe alan HttpContent türetilmiş bir sınıf döndürür.

İşlem tamamlandıktan sonra, döndürülen görev nesnesinde Result özelliği HTTP içeriğini temsil eden akışı içerir. Döndürülen akış daha sonra çeşitli akış API'leri kullanılarak içeriği okumak için kullanılabilir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, ReadAsStream()tarafından oluşan özel durumlara bakın.