HttpClient.GetStringAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

System.Net.Http.dll

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

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);

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

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

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).

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

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.

GetStringAsync(Uri)

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);

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

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

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).

TaskCanceledException

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.

GetStringAsync(String, CancellationToken)

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

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

L'elemento requestUri è null.

HttpRequestException

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).

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta specificato non è un URI relativo o assoluto valido.

OperationCanceledException

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.

GetStringAsync(Uri, CancellationToken)

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

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

L'elemento requestUri è null.

HttpRequestException

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).

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

OperationCanceledException

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.