HttpClient.PutAsync 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 PUT ke URI yang ditentukan sebagai operasi asinkron.
Overload
| Nama | Deskripsi |
|---|---|
| PutAsync(String, HttpContent) |
Kirim permintaan PUT ke URI yang ditentukan sebagai operasi asinkron. |
| PutAsync(Uri, HttpContent) |
Kirim permintaan PUT ke URI yang ditentukan sebagai operasi asinkron. |
| PutAsync(String, HttpContent, CancellationToken) |
Kirim permintaan PUT dengan token pembatalan sebagai operasi asinkron. |
| PutAsync(Uri, HttpContent, CancellationToken) |
Kirim permintaan PUT dengan token pembatalan sebagai operasi asinkron. |
Keterangan
Operasi ini tidak memblokir.
PutAsync(String, HttpContent)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan PUT ke URI yang ditentukan sebagai operasi asinkron.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string? requestUri, System.Net.Http.HttpContent? content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string? requestUri, System.Net.Http.HttpContent content);
member this.PutAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)
Parameter
- requestUri
- String
URI tempat permintaan dikirim.
- content
- HttpContent
Konten permintaan HTTP yang dikirim ke server.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri ini bukan URI absolut dan BaseAddress tidak diatur.
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.
URI permintaan yang disediakan tidak valid URI relatif atau absolut.
Keterangan
Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah 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.
Berlaku untuk
PutAsync(Uri, HttpContent)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan PUT ke URI yang ditentukan sebagai operasi asinkron.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri? requestUri, System.Net.Http.HttpContent? content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri? requestUri, System.Net.Http.HttpContent content);
member this.PutAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)
Parameter
- requestUri
- Uri
URI tempat permintaan dikirim.
- content
- HttpContent
Konten permintaan HTTP yang dikirim ke server.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri ini bukan URI absolut dan BaseAddress tidak diatur.
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.
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.
Berlaku untuk
PutAsync(String, HttpContent, CancellationToken)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan PUT dengan token pembatalan sebagai operasi asinkron.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
member this.PutAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)
Parameter
- requestUri
- String
URI tempat permintaan dikirim.
- content
- HttpContent
Konten permintaan HTTP yang dikirim ke server.
- cancellationToken
- CancellationToken
Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri ini bukan URI absolut dan BaseAddress tidak diatur.
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.
URI permintaan yang disediakan tidak valid URI relatif atau absolut.
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.
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.
Berlaku untuk
PutAsync(Uri, HttpContent, CancellationToken)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan PUT dengan token pembatalan sebagai operasi asinkron.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
member this.PutAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)
Parameter
- requestUri
- Uri
URI tempat permintaan dikirim.
- content
- HttpContent
Konten permintaan HTTP yang dikirim ke server.
- cancellationToken
- CancellationToken
Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri ini bukan URI absolut dan BaseAddress tidak diatur.
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.
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.