HttpClient Kelas
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.
Menyediakan kelas untuk mengirim permintaan HTTP dan menerima respons HTTP dari sumber daya yang diidentifikasi oleh URI.
public ref class HttpClient : System::Net::Http::HttpMessageInvoker
public class HttpClient : System.Net.Http.HttpMessageInvoker
type HttpClient = class
inherit HttpMessageInvoker
Public Class HttpClient
Inherits HttpMessageInvoker
- Warisan
Contoh
// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
static readonly HttpClient client = new HttpClient();
static async Task Main()
{
// Call asynchronous network methods in a try/catch block to handle exceptions.
try
{
using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();
// Above three lines can be replaced with new helper method below
// string responseBody = await client.GetStringAsync(uri);
Console.WriteLine(responseBody);
}
catch (HttpRequestException e)
{
Console.WriteLine("\nException Caught!");
Console.WriteLine("Message :{0} ", e.Message);
}
}
open System.Net.Http
// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
let client = new HttpClient()
let main =
task {
// Call asynchronous network methods in a try/catch block to handle exceptions.
try
use! response = client.GetAsync "http://www.contoso.com/"
response.EnsureSuccessStatusCode() |> ignore
let! responseBody = response.Content.ReadAsStringAsync()
// Above three lines can be replaced with new helper method below
// let! responseBody = client.GetStringAsync uri
printfn $"{responseBody}"
with
| :? HttpRequestException as e ->
printfn "\nException Caught!"
printfn $"Message :{e.Message} "
}
main.Wait()
' HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
Shared ReadOnly client As HttpClient = New HttpClient()
Private Shared Async Function Main() As Task
' Call asynchronous network methods in a try/catch block to handle exceptions.
Try
Using response As HttpResponseMessage = Await client.GetAsync("http://www.contoso.com/")
response.EnsureSuccessStatusCode()
Dim responseBody As String = Await response.Content.ReadAsStringAsync()
' Above three lines can be replaced with new helper method below
' Dim responseBody As String = Await client.GetStringAsync(uri)
Console.WriteLine(responseBody)
End Using
Catch e As HttpRequestException
Console.WriteLine(Environment.NewLine & "Exception Caught!")
Console.WriteLine("Message :{0} ", e.Message)
End Try
End Function
Keterangan
Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk HttpClient.
Konstruktor
HttpClient() |
Menginisialisasi instans HttpClient baru kelas menggunakan HttpClientHandler yang dibuang saat instans ini dibuang. |
HttpClient(HttpMessageHandler) |
Menginisialisasi instans HttpClient baru kelas dengan handler yang ditentukan. Handler dibuang ketika instans ini dibuang. |
HttpClient(HttpMessageHandler, Boolean) |
Menginisialisasi instans HttpClient baru kelas dengan handler yang disediakan, dan menentukan apakah handler tersebut harus dibuang saat instans ini dibuang. |
Properti
BaseAddress |
Mendapatkan atau mengatur alamat dasar Pengidentifikasi Sumber Daya Seragam (URI) dari sumber daya Internet yang digunakan saat mengirim permintaan. |
DefaultProxy |
Mendapatkan atau mengatur proksi HTTP global. |
DefaultRequestHeaders |
Mendapatkan header yang harus dikirim dengan setiap permintaan. |
DefaultRequestVersion |
Mendapatkan atau mengatur versi HTTP default yang digunakan pada permintaan berikutnya yang dibuat oleh instans ini HttpClient . |
DefaultVersionPolicy |
Mendapatkan atau menetapkan kebijakan versi default untuk permintaan yang dibuat secara implisit dalam metode kenyamanan, misalnya, GetAsync(String) dan PostAsync(String, HttpContent). |
MaxResponseContentBufferSize |
Mendapatkan atau mengatur jumlah maksimum byte ke buffer saat membaca konten respons. |
Timeout |
Mendapatkan atau mengatur rentang waktu untuk menunggu sebelum waktu permintaan habis. |
Metode
CancelPendingRequests() |
Batalkan semua permintaan yang tertunda pada instans ini. |
DeleteAsync(String) |
Kirim permintaan DELETE ke Uri yang ditentukan sebagai operasi asinkron. |
DeleteAsync(String, CancellationToken) |
Kirim permintaan DELETE ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron. |
DeleteAsync(Uri) |
Kirim permintaan DELETE ke Uri yang ditentukan sebagai operasi asinkron. |
DeleteAsync(Uri, CancellationToken) |
Kirim permintaan DELETE ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron. |
Dispose() |
Merilis sumber daya yang tidak dikelola dan membuang sumber daya terkelola yang digunakan oleh HttpMessageInvoker. (Diperoleh dari HttpMessageInvoker) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang HttpClient digunakan oleh dan secara opsional membuang sumber daya terkelola. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetAsync(String) |
Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron. |
GetAsync(String, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron. |
GetAsync(String, HttpCompletionOption) |
Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP sebagai operasi asinkron. |
GetAsync(String, HttpCompletionOption, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP dan token pembatalan sebagai operasi asinkron. |
GetAsync(Uri) |
Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron. |
GetAsync(Uri, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron. |
GetAsync(Uri, HttpCompletionOption) |
Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP sebagai operasi asinkron. |
GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP dan token pembatalan sebagai operasi asinkron. |
GetByteArrayAsync(String) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan isi respons sebagai array byte dalam operasi asinkron. |
GetByteArrayAsync(String, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan isi respons sebagai array byte dalam operasi asinkron. |
GetByteArrayAsync(Uri) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron. |
GetByteArrayAsync(Uri, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetStreamAsync(String) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai aliran dalam operasi asinkron. |
GetStreamAsync(String, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai aliran dalam operasi asinkron. |
GetStreamAsync(Uri) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai aliran dalam operasi asinkron. |
GetStreamAsync(Uri, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai aliran dalam operasi asinkron. |
GetStringAsync(String) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
GetStringAsync(String, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
GetStringAsync(Uri) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
GetStringAsync(Uri, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
PatchAsync(String, HttpContent) |
Mengirim permintaan PATCH ke Uri yang ditetapkan sebagai string sebagai operasi asinkron. |
PatchAsync(String, HttpContent, CancellationToken) |
Mengirim permintaan PATCH dengan token pembatalan ke Uri yang direpresentasikan sebagai string sebagai operasi asinkron. |
PatchAsync(Uri, HttpContent) |
Mengirim permintaan PATCH sebagai operasi asinkron. |
PatchAsync(Uri, HttpContent, CancellationToken) |
Mengirim permintaan PATCH dengan token pembatalan sebagai operasi asinkron. |
PostAsync(String, HttpContent) |
Kirim permintaan POST ke Uri yang ditentukan sebagai operasi asinkron. |
PostAsync(String, HttpContent, CancellationToken) |
Kirim permintaan POST dengan token pembatalan sebagai operasi asinkron. |
PostAsync(Uri, HttpContent) |
Kirim permintaan POST ke Uri yang ditentukan sebagai operasi asinkron. |
PostAsync(Uri, HttpContent, CancellationToken) |
Kirim permintaan POST dengan token pembatalan sebagai operasi asinkron. |
PutAsync(String, 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) |
Kirim permintaan PUT ke Uri yang ditentukan sebagai operasi asinkron. |
PutAsync(Uri, HttpContent, CancellationToken) |
Kirim permintaan PUT dengan token pembatalan sebagai operasi asinkron. |
Send(HttpRequestMessage) |
Mengirim permintaan HTTP dengan permintaan yang ditentukan. |
Send(HttpRequestMessage, CancellationToken) |
Mengirim permintaan HTTP dengan token permintaan dan pembatalan yang ditentukan. |
Send(HttpRequestMessage, CancellationToken) |
Mengirim permintaan HTTP dengan token permintaan dan pembatalan yang ditentukan. (Diperoleh dari HttpMessageInvoker) |
Send(HttpRequestMessage, HttpCompletionOption) |
Mengirim permintaan HTTP. |
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Mengirim permintaan HTTP dengan permintaan, opsi penyelesaian, dan token pembatalan yang ditentukan. |
SendAsync(HttpRequestMessage) |
Kirim permintaan HTTP sebagai operasi asinkron. |
SendAsync(HttpRequestMessage, CancellationToken) |
Kirim permintaan HTTP sebagai operasi asinkron. |
SendAsync(HttpRequestMessage, HttpCompletionOption) |
Kirim permintaan HTTP sebagai operasi asinkron. |
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Kirim permintaan HTTP sebagai operasi asinkron. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Metode Ekstensi
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken) |
Mengirim permintaan DELETE ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken) |
|
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync(HttpClient, String, Type, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken) |
Mengirim permintaan GET ke Uri yang ditentukan dan mengembalikan nilai yang dihasilkan dari deserialisasi isi respons sebagai JSON dalam operasi asinkron. |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan PATCH ke Uri yang ditentukan yang berisi |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan PATCH ke Uri yang ditentukan yang berisi |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Mengirim permintaan PATCH ke Uri yang ditentukan yang berisi |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan PATCH ke Uri yang ditentukan yang berisi |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan PATCH ke Uri yang ditentukan yang berisi |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Mengirim permintaan PATCH ke Uri yang ditentukan yang berisi |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan POST ke Uri yang ditentukan yang berisi |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan POST ke Uri yang ditentukan yang berisi |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Mengirim permintaan POST ke Uri yang ditentukan yang berisi |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Mengirim permintaan POST ke Uri yang ditentukan yang berisi |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Mengirim permintaan POST ke Uri yang ditentukan yang berisi |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Mengirim permintaan POST ke Uri yang ditentukan yang berisi |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Kirim permintaan PUT ke Uri yang ditentukan yang berisi |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Kirim permintaan PUT ke Uri yang ditentukan yang berisi |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Kirim permintaan PUT ke Uri yang ditentukan yang berisi |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Kirim permintaan PUT ke Uri yang ditentukan yang berisi |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Kirim permintaan PUT ke Uri yang ditentukan yang berisi |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Kirim permintaan PUT ke Uri yang ditentukan yang berisi |