HttpClient.GetStringAsync Yöntem

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kod:

System.Net.Http.dll

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini dize olarak döndürün.

Aşırı Yüklemeler

Name	Description
GetStringAsync(String)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini dize olarak döndürün.
GetStringAsync(Uri)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini dize olarak döndürün.

Açıklamalar

Bu işlem engellemez.

GetStringAsync(String)

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini dize olarak döndürün.

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)

Parametreler

requestUri

String

İsteğin gönderildiği URI.

Döndürülenler

Task<String>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

InvalidOperationException

requestUri mutlak bir URI değildir ve BaseAddress ayarlanmaz.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

-veya-

Yalnızca .NET Framework: İstek zaman aşımına uğradı.

OperationCanceledException

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

UriFormatException

Sağlanan istek URI'si geçerli göreli veya mutlak URI değil.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir TimeoutException iç içe yerleştiren bir OperationCanceledException oluşturur.

GetStringAsync(Uri)

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini dize olarak döndürün.

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)

Parametreler

requestUri

Uri

İsteğin gönderildiği URI.

Döndürülenler

Task<String>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

InvalidOperationException

requestUri mutlak bir URI değildir ve BaseAddress ayarlanmaz.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

-veya-

Yalnızca .NET Framework: İstek zaman aşımına uğradı.

OperationCanceledException

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir TimeoutException iç içe yerleştiren bir OperationCanceledException oluşturur.