HttpContent.ReadAsStreamAsync Metoda

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Serializuje obsah HTTP a vrátí datový proud, který představuje obsah.

Přetížení

ReadAsStreamAsync()	Serializace obsahu HTTP a vrácení datového proudu, který představuje obsah jako asynchronní operaci.
ReadAsStreamAsync(CancellationToken)	Serializace obsahu HTTP a vrácení datového proudu, který představuje obsah jako asynchronní operaci.

Poznámky

Všimněte si, že tato metoda interně uloží obsah do vyrovnávací paměti, pokud CreateContentReadStreamAsync() nebyla implementována jinak.

ReadAsStreamAsync()

Zdroj:

HttpContent.cs

Serializace obsahu HTTP a vrácení datového proudu, který představuje obsah jako asynchronní operaci.

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)

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci.

Poznámky

Tato operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po přečtení veškerého datového proudu, který představuje obsah.

Po dokončení operace obsahuje vlastnost Result vráceného objektu úlohy datový proud, který představuje obsah HTTP. Vrácený stream se pak dá použít ke čtení obsahu pomocí různých rozhraní API streamu.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané ReadAsStream().

ReadAsStreamAsync(CancellationToken)

Zdroj:

HttpContent.cs

Serializace obsahu HTTP a vrácení datového proudu, který představuje obsah jako asynchronní operaci.

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 zrušení pro zrušení operace.

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po přečtení veškerého datového proudu, který představuje obsah (pokud CreateContentReadStream(CancellationToken) nebyl implementován jinak). Například při použití HttpClientmetoda, například SendAsync vrátí třídu odvozenou z HttpContent, která podmíněně vyrovnávací paměti na základě toho, co je předáno pro completionOption parametr.

Po dokončení operace obsahuje vlastnost Result vráceného objektu úlohy datový proud, který představuje obsah HTTP. Vrácený stream se pak dá použít ke čtení obsahu pomocí různých rozhraní API streamu.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané ReadAsStream().