Sdílet prostřednictvím


HttpClient.GetStringAsync Metoda

Definice

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

Přetížení

GetStringAsync(String)

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

GetStringAsync(Uri)

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

GetStringAsync(String, CancellationToken)

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

GetStringAsync(Uri, CancellationToken)

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

Poznámky

Tato operace nebude blokována.

GetStringAsync(String)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

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)

Parametry

requestUri
String

Identifikátor URI, na který se požadavek odešle.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Platí pro

GetStringAsync(Uri)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

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)

Parametry

requestUri
Uri

Identifikátor URI, na který se požadavek odešle.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Platí pro

GetStringAsync(String, CancellationToken)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

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)

Parametry

requestUri
String

Identifikátor URI, na který se požadavek odešle.

cancellationToken
CancellationToken

Token zrušení pro zrušení operace.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Hodnota requestUri je null.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Platí pro

GetStringAsync(Uri, CancellationToken)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešlete požadavek GET do zadaného identifikátoru URI a vrátí text odpovědi jako řetězec v asynchronní operaci.

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)

Parametry

requestUri
Uri

Identifikátor URI, na který se požadavek odešle.

cancellationToken
CancellationToken

Token zrušení pro zrušení operace.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Hodnota requestUri je null.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Platí pro