HttpContent.ReadAsStreamAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Serializuje zawartość HTTP i zwraca strumień reprezentujący zawartość.

Przeciążenia

ReadAsStreamAsync()	Serializowanie zawartości HTTP i zwracanie strumienia reprezentującego zawartość jako operację asynchroniczną.
ReadAsStreamAsync(CancellationToken)	Serializowanie zawartości HTTP i zwracanie strumienia reprezentującego zawartość jako operację asynchroniczną.

Uwagi

Należy pamiętać, że ta metoda wewnętrznie buforuje zawartość, chyba że CreateContentReadStreamAsync() została zaimplementowana w inny sposób.

ReadAsStreamAsync()

Źródło:

HttpContent.cs

Serializowanie zawartości HTTP i zwracanie strumienia reprezentującego zawartość jako operację asynchroniczną.

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)

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną.

Uwagi

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po odczytaniu całego strumienia reprezentującego zawartość.

Po zakończeniu operacji właściwość Result zwróconego obiektu zadania zawiera strumień reprezentujący zawartość HTTP. Zwrócony strumień może następnie służyć do odczytywania zawartości przy użyciu różnych interfejsów API strumienia.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez ReadAsStream().

ReadAsStreamAsync(CancellationToken)

Źródło:

HttpContent.cs

Serializowanie zawartości HTTP i zwracanie strumienia reprezentującego zawartość jako operację asynchroniczną.

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)

Parametry

cancellationToken

CancellationToken

Token anulowania w celu anulowania operacji.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po odczytaniu całego strumienia reprezentującego zawartość (chyba że CreateContentReadStream(CancellationToken) został zaimplementowany w inny sposób). Na przykład w przypadku używania HttpClientmetoda, taka jak SendAsync, zwraca klasę pochodzącą z HttpContent, która warunkowo buforuje na podstawie tego, co jest przekazywane dla parametru completionOption.

Po zakończeniu operacji właściwość Result zwróconego obiektu zadania zawiera strumień reprezentujący zawartość HTTP. Zwrócony strumień może następnie służyć do odczytywania zawartości przy użyciu różnych interfejsów API strumienia.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez ReadAsStream().