HttpClient.GetStringAsync Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net.Http

Bütünleştirilmiş Kod:: System.Net.Http.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Kaynak:: HttpClient.cs

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

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 TaskCanceledException TimeoutExceptionoluşturur.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetStringAsync(Uri)

Kaynak:: HttpClient.cs

Kaynak:: HttpClient.cs

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

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 TaskCanceledException TimeoutExceptionoluşturur.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetStringAsync(String, CancellationToken)

Kaynak:: HttpClient.cs

Kaynak:: HttpClient.cs

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 TaskCanceledException TimeoutExceptionoluşturur.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	5, 6, 7, 8, 9

GetStringAsync(Uri, CancellationToken)

Kaynak:: HttpClient.cs

Kaynak:: HttpClient.cs

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 TaskCanceledException TimeoutExceptionoluşturur.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	5, 6, 7, 8, 9

Aracılığıyla paylaş

HttpClient.GetStringAsync Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

GetStringAsync(String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

GetStringAsync(Uri)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

GetStringAsync(String, CancellationToken)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

GetStringAsync(Uri, CancellationToken)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar