HttpClient.GetStreamAsync Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona.
| GetStreamAsync(Uri, CancellationToken) |
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona. |
| GetStreamAsync(String, CancellationToken) |
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona. |
| GetStreamAsync(Uri) |
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona. |
| GetStreamAsync(String) |
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona. |
A operação não será bloqueada.
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona.
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
O URI ao qual a solicitação é enviada.
- cancellationToken
- CancellationToken
O token de cancelamento para cancelar a operação.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri é null.
Falha na solicitação devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor (ou tempo limite apenas para .NET Framework).
Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Essa operação não será bloqueada. O objeto Task< Stream> retornado será concluído após a leitura dos cabeçalhos de resposta. Esse método não lê nem armazena em buffer o corpo da resposta.
Observação
No caso de um tempo limite:
- .NET Framework lança um HttpRequestException.
- O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
- O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona.
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
O URI ao qual a solicitação é enviada.
- cancellationToken
- CancellationToken
O token de cancelamento para cancelar a operação.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Essa operação não será bloqueada. O objeto Task< Stream> retornado será concluído após a leitura dos cabeçalhos de resposta. Esse método não lê nem armazena em buffer o corpo da resposta.
Observação
No caso de um tempo limite:
- .NET Framework lança um HttpRequestException.
- O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
- O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);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
O URI ao qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.
Falha na solicitação devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor (ou tempo limite apenas para .NET Framework).
Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não será bloqueada. O objeto Task< Stream> retornado será concluído após a leitura dos cabeçalhos de resposta. Esse método não lê nem armazena em buffer o corpo da resposta.
Observação
No caso de um tempo limite:
- .NET Framework lança um HttpRequestException.
- O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
- O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um fluxo em uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (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
O URI ao qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.
Falha na solicitação devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor (ou tempo limite apenas para .NET Framework).
Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.
O URI de solicitação fornecido não é URI relativo ou absoluto válido.
Comentários
Essa operação não será bloqueada. O objeto Task< Stream> retornado será concluído após a leitura dos cabeçalhos de resposta. Esse método não lê nem armazena em buffer o corpo da resposta.
Observação
No caso de um tempo limite:
- .NET Framework lança um HttpRequestException.
- O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
- O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: