HttpClient.GetStreamAsync Método

Definición

Espacio de nombres:

System.Net.Http

Ensamblado:

System.Net.Http.dll

Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.

Sobrecargas

GetStreamAsync(Uri, CancellationToken)	Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.
GetStreamAsync(String, CancellationToken)	Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.
GetStreamAsync(Uri)	Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.
GetStreamAsync(String)	Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.

Comentarios

La operación no se bloqueará.

GetStreamAsync(Uri, CancellationToken)

Source:

HttpClient.cs

Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.

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)

Parámetros

requestUri

Uri

URI al que se envía la solicitud.

cancellationToken

CancellationToken

Token de cancelación para cancelar la operación.

Devoluciones

Task<Stream>

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentNullException

El valor de requestUri es null.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor (o el tiempo de espera solo para .NET Framework).

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto Task<Stream> devuelto se completará una vez leídos los encabezados de respuesta. Este método no lee ni almacena en búfer el cuerpo de la respuesta.

Nota:

En el caso de un tiempo de espera:

• .NET Framework inicia una HttpRequestExceptionexcepción .
• .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
• .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.

GetStreamAsync(String, CancellationToken)

Source:

HttpClient.cs

Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.

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)

Parámetros

requestUri

String

URI al que se envía la solicitud.

cancellationToken

CancellationToken

Token de cancelación para cancelar la operación.

Devoluciones

Task<Stream>

Objeto de tarea que representa la operación asincrónica.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto Task<Stream> devuelto se completará una vez leídos los encabezados de respuesta. Este método no lee ni almacena en búfer el cuerpo de la respuesta.

Nota:

En el caso de un tiempo de espera:

• .NET Framework inicia una HttpRequestExceptionexcepción .
• .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
• .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.

GetStreamAsync(Uri)

Source:

HttpClient.cs

Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.

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)

Parámetros

requestUri

Uri

URI al que se envía la solicitud.

Devoluciones

Task<Stream>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor (o el tiempo de espera solo para .NET Framework).

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloqueará. El objeto Task<Stream> devuelto se completará una vez leídos los encabezados de respuesta. Este método no lee ni almacena en búfer el cuerpo de la respuesta.

Nota:

En el caso de un tiempo de espera:

• .NET Framework inicia una HttpRequestExceptionexcepción .
• .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
• .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.

GetStreamAsync(String)

Source:

HttpClient.cs

Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.

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)

Parámetros

requestUri

String

URI al que se envía la solicitud.

Devoluciones

Task<Stream>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor (o el tiempo de espera solo para .NET Framework).

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

UriFormatException

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

Comentarios

Esta operación no se bloqueará. El objeto Task<Stream> devuelto se completará una vez leídos los encabezados de respuesta. Este método no lee ni almacena en búfer el cuerpo de la respuesta.

Nota:

En el caso de un tiempo de espera:

• .NET Framework inicia una HttpRequestExceptionexcepción .
• .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
• .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.