HttpClient.GetStreamAsync Metoda

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.

Přetížení

GetStreamAsync(Uri, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStreamAsync(String, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStreamAsync(Uri)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStreamAsync(String)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.

Poznámky

Operace nebude blokována.

GetStreamAsync(Uri, CancellationToken)

Zdroj:

HttpClient.cs

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Stream)

Parametry

requestUri

Uri

Identifikátor URI, na který se požadavek odešle.

cancellationToken

CancellationToken

Token zrušení pro zrušení operace.

Návraty

Task<Stream>

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

Výjimky

ArgumentNullException

Hodnota requestUri je null.

HttpRequestException

Žádost selhala kvůli základnímu problému, jako je například připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

OperationCanceledException

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

Poznámky

Tato operace nebude blokována. Vrácený objekt Task< Stream> se dokončí po přečtení hlaviček odpovědi. Tato metoda nečte ani neukládá tělo odpovědi do vyrovnávací paměti.

Poznámka

V případě vypršení časového limitu:

• Rozhraní .NET Framework vyvolá .HttpRequestException
• .NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
• .NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.

GetStreamAsync(String, CancellationToken)

Zdroj:

HttpClient.cs

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Stream)

Parametry

requestUri

String

Identifikátor URI, na který se požadavek odešle.

cancellationToken

CancellationToken

Token zrušení pro zrušení operace.

Návraty

Task<Stream>

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

Výjimky

OperationCanceledException

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

Poznámky

Tato operace nebude blokována. Vrácený objekt Task< Stream> se dokončí po přečtení hlaviček odpovědi. Tato metoda nečte ani neukládá tělo odpovědi do vyrovnávací paměti.

Poznámka

V případě vypršení časového limitu:

• Rozhraní .NET Framework vyvolá .HttpRequestException
• .NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
• .NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.

GetStreamAsync(Uri)

Zdroj:

HttpClient.cs

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri);

member this.GetStreamAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri) As Task(Of Stream)

Parametry

requestUri

Uri

Identifikátor URI, na který se požadavek odešle.

Návraty

Task<Stream>

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

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žádost selhala kvůli základnímu problému, jako je například připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Poznámky

Tato operace nebude blokována. Vrácený objekt Task< Stream> se dokončí po přečtení hlaviček odpovědi. Tato metoda nečte ani neukládá tělo odpovědi do vyrovnávací paměti.

Poznámka

V případě vypršení časového limitu:

• Rozhraní .NET Framework vyvolá .HttpRequestException
• .NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
• .NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.

GetStreamAsync(String)

Zdroj:

HttpClient.cs

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri);

member this.GetStreamAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String) As Task(Of Stream)

Parametry

requestUri

String

Identifikátor URI, na který se požadavek odešle.

Návraty

Task<Stream>

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

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žádost selhala kvůli základnímu problému, jako je například připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

UriFormatException

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Poznámky

Tato operace nebude blokována. Vrácený objekt Task< Stream> se dokončí po přečtení hlaviček odpovědi. Tato metoda nečte ani neukládá tělo odpovědi do vyrovnávací paměti.

Poznámka

V případě vypršení časového limitu:

• Rozhraní .NET Framework vyvolá .HttpRequestException
• .NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
• .NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.