HttpClient.SendAsync Yöntem

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Http.dll

Http isteğini zaman uyumsuz bir işlem olarak gönderin.

Aşırı Yüklemeler

Name	Description
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Http isteğini zaman uyumsuz bir işlem olarak gönderin.
SendAsync(HttpRequestMessage)	Http isteğini zaman uyumsuz bir işlem olarak gönderin.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Http isteğini zaman uyumsuz bir işlem olarak gönderin.
SendAsync(HttpRequestMessage, CancellationToken)	Http isteğini zaman uyumsuz bir işlem olarak gönderin.

Açıklamalar

Bu işlem engellemez.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Kaynak:

HttpClient.cs

Http isteğini zaman uyumsuz bir işlem olarak gönderin.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametreler

request

HttpRequestMessage

Gönderilecek HTTP isteği iletisi.

completionOption

HttpCompletionOption

İşlemin tamamlanması gerektiğinde (yanıt kullanılabilir olduğunda veya yanıt içeriğinin tamamını okuduktan sonra).

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<HttpResponseMessage>

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

Özel durumlar

ArgumentNullException

request şudur: null.

InvalidOperationException

İstek iletisi zaten örnek tarafından HttpClient gönderilmişti.

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-

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

OperationCanceledException

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

-veya-

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

Açıklamalar

Bu işlem engellemez. parametresinin completionOption değerine bağlı olarak, yanıt kullanılabilir olduğunda veya içerik de dahil olmak üzere yanıtın tamamı okunduktan sonra döndürülen Task<TResult> nesne tamamlanır.

Note

Zaman aşımı durumunda, farklı .NET uygulamalarında farklı özel durumlar oluşturulur.

• HttpRequestException tüm geçerli .NET Framework sürümlerinde oluşturulur.
• OperationCanceledException herhangi bir iç özel durum olmadan tüm geçerli .NET Core sürümlerinde oluşturulur.
• OperationCanceledException iç içe yerleştiren TimeoutException .NET 5 ve sonraki sürümlerde oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(HttpRequestMessage, HttpCompletionOption)oluşan özel durumlara bakın.

SendAsync(HttpRequestMessage)

Kaynak:

HttpClient.cs

Http isteğini zaman uyumsuz bir işlem olarak gönderin.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request);

override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)

Parametreler

request

HttpRequestMessage

Gönderilecek HTTP isteği iletisi.

Döndürülenler

Task<HttpResponseMessage>

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

Özel durumlar

ArgumentNullException

request şudur: null.

InvalidOperationException

İstek iletisi zaten örnek tarafından HttpClient gönderilmişti.

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-

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, içerik de dahil olmak üzere tüm yanıt okunduktan sonra tamamlanır. Davranış, açıkça belirtilmiş olmasıyla ResponseContentRead aynıdır.

Note

Zaman aşımı durumunda, farklı .NET uygulamalarında farklı özel durumlar oluşturulur.

• HttpRequestException tüm geçerli .NET Framework sürümlerinde oluşturulur.
• OperationCanceledException herhangi bir iç özel durum olmadan tüm geçerli .NET Core sürümlerinde oluşturulur.
• OperationCanceledException iç içe yerleştiren TimeoutException .NET 5 ve sonraki sürümlerde oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(HttpRequestMessage)oluşan özel durumlara bakın.

SendAsync(HttpRequestMessage, HttpCompletionOption)

Kaynak:

HttpClient.cs

Http isteğini zaman uyumsuz bir işlem olarak gönderin.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);

override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parametreler

request

HttpRequestMessage

Gönderilecek HTTP isteği iletisi.

completionOption

HttpCompletionOption

İşlemin tamamlanması gerektiğinde (yanıt kullanılabilir olduğunda veya yanıt içeriğinin tamamını okuduktan sonra).

Döndürülenler

Task<HttpResponseMessage>

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

Özel durumlar

ArgumentNullException

request şudur: null.

InvalidOperationException

İstek iletisi zaten örnek tarafından HttpClient gönderilmişti.

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-

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. parametresinin completionOption değerine bağlı olarak, yanıt kullanılabilir olduğunda veya içerik de dahil olmak üzere yanıtın tamamı okunduktan sonra döndürülen Task<TResult> nesne tamamlanır.

Note

Zaman aşımı durumunda, farklı .NET uygulamalarında farklı özel durumlar oluşturulur.

• HttpRequestException tüm geçerli .NET Framework sürümlerinde oluşturulur.
• OperationCanceledException herhangi bir iç özel durum olmadan tüm geçerli .NET Core sürümlerinde oluşturulur.
• OperationCanceledException iç içe yerleştiren TimeoutException .NET 5 ve sonraki sürümlerde oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(HttpRequestMessage, HttpCompletionOption)oluşan özel durumlara bakın.

SendAsync(HttpRequestMessage, CancellationToken)

Kaynak:

HttpClient.cs

Http isteğini zaman uyumsuz bir işlem olarak gönderin.

public:
 override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametreler

request

HttpRequestMessage

Gönderilecek HTTP isteği iletisi.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<HttpResponseMessage>

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

Özel durumlar

ArgumentNullException

request şudur: null.

InvalidOperationException

İstek iletisi zaten örnek tarafından HttpClient gönderilmişti.

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-

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

OperationCanceledException

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

-veya-

.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, içerik de dahil olmak üzere tüm yanıt okunduktan sonra tamamlanır. Davranış, açıkça belirtilmiş olmasıyla ResponseContentRead aynıdır.

Note

Zaman aşımı durumunda, farklı .NET uygulamalarında farklı özel durumlar oluşturulur.

• HttpRequestException tüm geçerli .NET Framework sürümlerinde oluşturulur.
• OperationCanceledException herhangi bir iç özel durum olmadan tüm geçerli .NET Core sürümlerinde oluşturulur.
• OperationCanceledException iç içe yerleştiren TimeoutException .NET 5 ve sonraki sürümlerde oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(HttpRequestMessage)oluşan özel durumlara bakın.