HttpContent.ReadAsStreamAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Źródło:
- HttpContent.cs
- Ź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
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().
Dotyczy
ReadAsStreamAsync(CancellationToken)
- Źródło:
- HttpContent.cs
- Źródło:
- HttpContent.cs
- Ź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
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
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().
