HttpClient.GetStringAsync Metódus

Definíció

Névtér:

System.Net.Http

Szerelvények:

netstandard.dll, System.Net.Http.dll

Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.

Túlterhelések

Name	Description
GetStringAsync(String)	Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.
GetStringAsync(Uri)	Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.
GetStringAsync(String, CancellationToken)	Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.
GetStringAsync(Uri, CancellationToken)	Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.

Megjegyzések

Ez a művelet nem tiltja le.

GetStringAsync(String)

Forrás:

HttpClient.cs

Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.

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)

Paraméterek

requestUri

String

A kérelem URI-ja.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

InvalidOperationException

Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.

HttpRequestException

A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError

-vagy-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

-vagy-

csak .NET keretrendszer: A kérés túllépte az időkorlátot.

OperationCanceledException

.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.

UriFormatException

A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.

Megjegyzések

Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes választörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.

GetStringAsync(Uri)

Forrás:

HttpClient.cs

Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.

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)

Paraméterek

requestUri

Uri

A kérelem URI-ja.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

InvalidOperationException

Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.

HttpRequestException

A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError

-vagy-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

-vagy-

csak .NET keretrendszer: A kérés túllépte az időkorlátot.

OperationCanceledException

.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.

Megjegyzések

Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes választörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.

GetStringAsync(String, CancellationToken)

Forrás:

HttpClient.cs

Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.

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)

Paraméterek

requestUri

String

A kérelem URI-ja.

cancellationToken

CancellationToken

A művelet megszakításához szükséges lemondási jogkivonat.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

ArgumentNullException

Az requestUri van null.

HttpRequestException

A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError

-vagy-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

UriFormatException

A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

-vagy-

.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.

Megjegyzések

Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes választörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.

GetStringAsync(Uri, CancellationToken)

Forrás:

HttpClient.cs

Küldjön get kérést a megadott URI-nak, és sztringként adja vissza a válasz törzsét egy aszinkron műveletben.

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)

Paraméterek

requestUri

Uri

A kérelem URI-ja.

cancellationToken

CancellationToken

A művelet megszakításához szükséges lemondási jogkivonat.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

ArgumentNullException

Az requestUri van null.

HttpRequestException

A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError

-vagy-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

-vagy-

.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.

Megjegyzések

Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes választörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.