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
| Nama | Deskripsi |
|---|---|
| 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 memblokir.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- 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 saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError
-atau-
.NET Framework saja: waktu permintaan habis.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
-atau-
.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.
Keterangan
Operasi ini tidak memblokir. Bergantung pada nilai completionOption parameter, objek yang dikembalikan Task<TResult> akan selesai segera setelah respons tersedia atau seluruh respons termasuk konten dibaca.
Note
Jika waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.
- HttpRequestException dilemparkan pada semua versi .NET Framework yang berlaku.
- OperationCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
- OperationCanceledException yang menumpuk TimeoutException dilemparkan pada versi .NET 5 dan yang lebih baru.
Metode ini disimpan dalam tugas yang mengembalikan 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
- 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 saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError
-atau-
.NET Framework saja: Waktu permintaan habis.
.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.
Keterangan
Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh respons termasuk konten dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.
Note
Jika waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.
- HttpRequestException dilemparkan pada semua versi .NET Framework yang berlaku.
- OperationCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
- OperationCanceledException yang menumpuk TimeoutException dilemparkan pada versi .NET 5 dan yang lebih baru.
Metode ini disimpan dalam tugas yang mengembalikan 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
- 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 saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError
-atau-
.NET Framework saja: Waktu permintaan habis.
.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.
Keterangan
Operasi ini tidak memblokir. Bergantung pada nilai completionOption parameter, objek yang dikembalikan Task<TResult> akan selesai segera setelah respons tersedia atau seluruh respons termasuk konten dibaca.
Note
Jika waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.
- HttpRequestException dilemparkan pada semua versi .NET Framework yang berlaku.
- OperationCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
- OperationCanceledException yang menumpuk TimeoutException dilemparkan pada versi .NET 5 dan yang lebih baru.
Metode ini disimpan dalam tugas yang mengembalikan 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
- 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 saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError
-atau-
.NET Framework saja: Waktu permintaan habis.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
-atau-
.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.
Keterangan
Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh respons termasuk konten dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.
Note
Jika waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.
- HttpRequestException dilemparkan pada semua versi .NET Framework yang berlaku.
- OperationCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
- OperationCanceledException yang menumpuk TimeoutException dilemparkan pada versi .NET 5 dan yang lebih baru.
Metode ini disimpan dalam tugas yang mengembalikan 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).
