HttpClient.SendAsync Metode

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

Kirim permintaan HTTP sebagai operasi asinkron.

Overload

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Kirim permintaan HTTP sebagai operasi asinkron.
SendAsync(HttpRequestMessage)	Kirim permintaan HTTP sebagai operasi asinkron.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Kirim permintaan HTTP sebagai operasi asinkron.
SendAsync(HttpRequestMessage, CancellationToken)	Kirim permintaan HTTP sebagai operasi asinkron.

Keterangan

Operasi ini tidak akan memblokir.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan HTTP sebagai operasi asinkron.

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)

Parameter

request

HttpRequestMessage

Pesan permintaan HTTP untuk dikirim.

completionOption

HttpCompletionOption

Ketika operasi harus selesai (segera setelah respons tersedia atau setelah membaca seluruh konten respons).

cancellationToken

CancellationToken

Token pembatalan untuk membatalkan operasi.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

request adalah null.

InvalidOperationException

Pesan permintaan sudah dikirim oleh HttpClient instans.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Bergantung pada nilai completionOption parameter, objek yang dikembalikan Task<TResult> akan selesai segera setelah respons tersedia atau seluruh respons termasuk konten dibaca.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk a TimeoutException dilemparkan pada .NET 5 dan versi yang lebih baru.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(HttpRequestMessage, HttpCompletionOption).

SendAsync(HttpRequestMessage)

Sumber:

HttpClient.cs

Kirim permintaan HTTP sebagai operasi asinkron.

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)

Parameter

request

HttpRequestMessage

Pesan permintaan HTTP untuk dikirim.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

request adalah null.

InvalidOperationException

Pesan permintaan sudah dikirim oleh HttpClient instans.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh respons termasuk konten dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk a TimeoutException dilemparkan pada .NET 5 dan versi yang lebih baru.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(HttpRequestMessage).

SendAsync(HttpRequestMessage, HttpCompletionOption)

Sumber:

HttpClient.cs

Kirim permintaan HTTP sebagai operasi asinkron.

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)

Parameter

request

HttpRequestMessage

Pesan permintaan HTTP untuk dikirim.

completionOption

HttpCompletionOption

Ketika operasi harus selesai (segera setelah respons tersedia atau setelah membaca seluruh konten respons).

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

request adalah null.

InvalidOperationException

Pesan permintaan sudah dikirim oleh HttpClient instans.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

Keterangan

Operasi ini tidak akan memblokir. Bergantung pada nilai completionOption parameter, objek yang dikembalikan Task<TResult> akan selesai segera setelah respons tersedia atau seluruh respons termasuk konten dibaca.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk a TimeoutException dilemparkan pada .NET 5 dan versi yang lebih baru.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(HttpRequestMessage, HttpCompletionOption).

SendAsync(HttpRequestMessage, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan HTTP sebagai operasi asinkron.

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)

Parameter

request

HttpRequestMessage

Pesan permintaan HTTP untuk dikirim.

cancellationToken

CancellationToken

Token pembatalan untuk membatalkan operasi.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

request adalah null.

InvalidOperationException

Pesan permintaan sudah dikirim oleh HttpClient instans.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh respons termasuk konten dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk a TimeoutException dilemparkan pada .NET 5 dan versi yang lebih baru.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(HttpRequestMessage).