HttpClient.SendAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Sumber:
- HttpClient.cs
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
request adalah null.
Pesan permintaan sudah dikirim oleh HttpClient instans.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.
.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.
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).
Berlaku untuk
SendAsync(HttpRequestMessage)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
request adalah null.
Pesan permintaan sudah dikirim oleh HttpClient instans.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.
.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).
Berlaku untuk
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
request adalah null.
Pesan permintaan sudah dikirim oleh HttpClient instans.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.
.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).
Berlaku untuk
SendAsync(HttpRequestMessage, CancellationToken)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
request adalah null.
Pesan permintaan sudah dikirim oleh HttpClient instans.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.
.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.
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).
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk