Partilhar via


HttpClient.GetStringAsync Método

Definição

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma cadeia de caracteres em uma operação assíncrona.

Sobrecargas

GetStringAsync(String)

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma cadeia de caracteres em uma operação assíncrona.

GetStringAsync(Uri)

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma cadeia de caracteres em uma operação assíncrona.

GetStringAsync(String, CancellationToken)

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma cadeia de caracteres em uma operação assíncrona.

GetStringAsync(Uri, CancellationToken)

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma cadeia de caracteres em uma operação assíncrona.

Comentários

Essa operação não será bloqueada.

GetStringAsync(String)

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 uma cadeia de caracteres em uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);
member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String) As Task(Of String)

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 retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

Aplica-se a

GetStringAsync(Uri)

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 uma cadeia de caracteres em uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);
member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri) As Task(Of String)

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 retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

Aplica-se a

GetStringAsync(String, CancellationToken)

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 uma cadeia de caracteres em uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)

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 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 URI de solicitação fornecido não é URI relativo ou absoluto válido.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

Aplica-se a

GetStringAsync(Uri, CancellationToken)

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 uma cadeia de caracteres em uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)

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 retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

Aplica-se a