HttpContent.ReadAsStreamAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestawy:

netstandard.dll, System.Net.Http.dll

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

Przeciążenia

Nazwa	Opis
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 zostanie ukończony Task<TResult> po odczytaniu całego strumienia reprezentującego zawartość.

Po zakończeniu Result operacji właściwość 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. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program 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 zostanie ukończony Task<TResult> 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 HttpClientmetody , takiej jak SendAsync metoda zwraca klasę pochodzącą z HttpContent tego warunkowego buforu w oparciu o to, co jest przekazywane dla parametru completionOption .

Po zakończeniu Result operacji właściwość 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. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program ReadAsStream().