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 yanıt gövdesini zaman uyumsuz bir işlemde dize olarak döndürin.

Aşırı Yüklemeler

GetStringAsync(String)	Belirtilen Uri'ye bir GET isteği gönderin ve yanıt gövdesini zaman uyumsuz bir işlemde dize olarak döndürin.
GetStringAsync(Uri)	Belirtilen Uri'ye bir GET isteği gönderin ve yanıt gövdesini zaman uyumsuz bir işlemde dize olarak döndürin.
GetStringAsync(String, CancellationToken)	Belirtilen Uri'ye bir GET isteği gönderin ve yanıt gövdesini zaman uyumsuz bir işlemde dize olarak döndürin.
GetStringAsync(Uri, CancellationToken)	Belirtilen Uri'ye bir GET isteği gönderin ve yanıt gövdesini zaman uyumsuz bir işlemde dize olarak döndürin.

Açıklamalar

Bu işlem engellemez.

GetStringAsync(String)

Kaynak:

HttpClient.cs

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

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

mutlak requestUri bir URI olmalıdır veya BaseAddress ayarlanmalıdır.

HttpRequestException

Ağ bağlantısı, DNS hatası, sunucu sertifikası doğrulaması (veya yalnızca .NET Framework için zaman aşımı) gibi temel alınan bir sorun nedeniyle istek başarısız oldu.

TaskCanceledException

Yalnızca .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.

Not

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestExceptionatar.
• .NET Core herhangi bir iç özel durum olmadan bir TaskCanceledException oluşturur.
• .NET 5 ve sonraki sürümleri bir iç içe yerleştirilmiş bir TaskCanceledExceptionTimeoutExceptionoluşturur.

GetStringAsync(Uri)

Kaynak:

HttpClient.cs

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

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

mutlak requestUri bir URI olmalıdır veya BaseAddress ayarlanmalıdır.

HttpRequestException

Ağ bağlantısı, DNS hatası, sunucu sertifikası doğrulaması (veya yalnızca .NET Framework için zaman aşımı) gibi temel alınan bir sorun nedeniyle istek başarısız oldu.

TaskCanceledException

Yalnızca .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.

Not

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestExceptionatar.
• .NET Core herhangi bir iç özel durum olmadan bir TaskCanceledException oluşturur.
• .NET 5 ve sonraki sürümleri bir iç içe yerleştirilmiş bir TaskCanceledExceptionTimeoutExceptionoluşturur.

GetStringAsync(String, CancellationToken)

Kaynak:

HttpClient.cs

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

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)

Parametreler

requestUri

String

İsteğin gönderildiği Uri.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<String>

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

Özel durumlar

ArgumentNullException

, requestUri şeklindedir null.

HttpRequestException

Ağ bağlantısı, DNS hatası, sunucu sertifikası doğrulaması (veya yalnızca .NET Framework için zaman aşımı) gibi temel alınan bir sorun nedeniyle istek başarısız oldu.

TaskCanceledException

Yalnızca .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.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır.

Not

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestExceptionatar.
• .NET Core herhangi bir iç özel durum olmadan bir TaskCanceledException oluşturur.
• .NET 5 ve sonraki sürümleri bir iç içe yerleştirilmiş bir TaskCanceledExceptionTimeoutExceptionoluşturur.

GetStringAsync(Uri, CancellationToken)

Kaynak:

HttpClient.cs

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

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)

Parametreler

requestUri

Uri

İsteğin gönderildiği Uri.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<String>

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

Özel durumlar

ArgumentNullException

, requestUri şeklindedir null.

HttpRequestException

Ağ bağlantısı, DNS hatası, sunucu sertifikası doğrulaması (veya yalnızca .NET Framework için zaman aşımı) gibi temel alınan bir sorun nedeniyle istek başarısız oldu.

TaskCanceledException

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

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır.

Not

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestExceptionatar.
• .NET Core herhangi bir iç özel durum olmadan bir TaskCanceledException oluşturur.
• .NET 5 ve sonraki sürümleri bir iç içe yerleştirilmiş bir TaskCanceledExceptionTimeoutExceptionoluşturur.