HttpClient.GetStringAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
Overload
| GetStringAsync(String) |
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona. |
| GetStringAsync(Uri) |
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona. |
| GetStringAsync(String, CancellationToken) |
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona. |
| GetStringAsync(Uri, CancellationToken) |
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona. |
Commenti
Questa operazione non verrà bloccata.
GetStringAsync(String)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
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)Parametri
- requestUri
- String
L'URI a cui viene inviata la richiesta.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.
La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).
Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
L'URI della richiesta specificato non è un URI relativo o assoluto valido.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.
Nota
In caso di timeout:
- .NET Framework genera un'eccezione HttpRequestException.
- .NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
- .NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.
Si applica a
GetStringAsync(Uri)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
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)Parametri
- requestUri
- Uri
L'URI a cui viene inviata la richiesta.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.
La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).
Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.
Nota
In caso di timeout:
- .NET Framework genera un'eccezione HttpRequestException.
- .NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
- .NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.
Si applica a
GetStringAsync(String, CancellationToken)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
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)Parametri
- requestUri
- String
L'URI a cui viene inviata la richiesta.
- cancellationToken
- CancellationToken
Token di annullamento per annullare l'operazione.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'elemento requestUri è null.
La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).
Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
L'URI della richiesta specificato non è un URI relativo o assoluto valido.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.
Nota
In caso di timeout:
- .NET Framework genera un'eccezione HttpRequestException.
- .NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
- .NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.
Si applica a
GetStringAsync(Uri, CancellationToken)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
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)Parametri
- requestUri
- Uri
L'URI a cui viene inviata la richiesta.
- cancellationToken
- CancellationToken
Token di annullamento per annullare l'operazione.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'elemento requestUri è null.
La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).
Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.
Nota
In caso di timeout:
- .NET Framework genera un'eccezione HttpRequestException.
- .NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
- .NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.
