System.Net.Http Ruang nama
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 antarmuka pemrograman untuk aplikasi HTTP modern.
Kelas
ByteArrayContent |
Menyediakan konten HTTP berdasarkan array byte. |
DelegatingHandler |
Jenis untuk handler HTTP yang mendelegasikan pemrosesan pesan respons HTTP ke handler lain, yang disebut handler dalam. |
FormUrlEncodedContent |
Kontainer untuk tuple nama/nilai yang dikodekan menggunakan jenis MIME application/x-www-form-urlencoded. |
HttpClient |
Menyediakan kelas untuk mengirim permintaan HTTP dan menerima respons HTTP dari sumber daya yang diidentifikasi oleh URI. |
HttpClientFactoryExtensions |
Metode ekstensi untuk IHttpClientFactory. |
HttpClientHandler |
Handler pesan default yang digunakan oleh HttpClient di .NET Framework dan .NET Core 2.0 dan yang lebih lama. |
HttpContent |
Kelas dasar yang mewakili isi entitas HTTP dan header konten. |
HttpDiagnosticsHttpRequestMessageExtensions |
Ekstensi untuk utilitas telemetri. |
HttpIOException |
Pengecualian yang dilemparkan ketika kesalahan terjadi saat membaca respons. |
HttpMessageHandler |
Jenis dasar untuk penangan pesan HTTP. |
HttpMessageHandlerFactoryExtensions |
Metode ekstensi untuk IHttpMessageHandlerFactory. |
HttpMessageInvoker |
Kelas khusus yang memungkinkan aplikasi untuk memanggil SendAsync(HttpRequestMessage, CancellationToken) metode pada rantai handler HTTP. |
HttpMethod |
Kelas pembantu untuk mengambil dan membandingkan metode HTTP standar dan untuk membuat metode HTTP baru. |
HttpProtocolException |
Pengecualian dilemparkan ketika kesalahan protokol HTTP/2 atau HTTP/3 terjadi. |
HttpRequestException |
Kelas dasar untuk pengecualian yang dilemparkan HttpClient oleh kelas dan HttpMessageHandler . |
HttpRequestMessage |
Mewakili pesan permintaan HTTP. |
HttpRequestOptions |
Mewakili kumpulan opsi untuk permintaan HTTP. |
HttpResilienceHttpRequestMessageExtensions |
Ekstensi ketahanan untuk HttpRequestMessage. |
HttpResponseMessage |
Mewakili pesan respons HTTP termasuk kode status dan data. |
MessageProcessingHandler |
Jenis dasar untuk handler yang hanya melakukan beberapa pemrosesan kecil pesan permintaan dan/atau respons. |
MultipartContent |
Menyediakan kumpulan HttpContent objek yang diserialisasikan menggunakan spesifikasi jenis konten multipart/*. |
MultipartFormDataContent |
Menyediakan kontainer untuk konten yang dikodekan menggunakan jenis MIME multipart/form-data. |
ReadOnlyMemoryContent |
Menyediakan konten HTTP berdasarkan ReadOnlyMemory<T>. |
RtcRequestFactory |
Menyediakan antarmuka pemrograman untuk aplikasi HTTP modern. |
SocketsHttpConnectionContext |
Mewakili konteks yang diteruskan ke ConnectCallback untuk SocketsHttpHandler instans. . |
SocketsHttpHandler |
Menyediakan penangan pesan default yang digunakan oleh HttpClient di .NET Core 2.1 dan yang lebih baru. |
SocketsHttpPlaintextStreamFilterContext |
Mewakili konteks yang diteruskan ke PlaintextStreamFilter untuk instans SocketsHttpHandler. |
StreamContent |
Menyediakan konten HTTP berdasarkan aliran. |
StringContent |
Menyediakan konten HTTP berdasarkan string. |
WebRequestHandler |
Menyediakan fitur khusus desktop yang tidak tersedia untuk aplikasi Bursa Windows atau lingkungan lainnya. |
WinHttpHandler |
Menangani pesan berdasarkan antarmuka WinHTTP Windows. Kelas ini ditujukan untuk digunakan di lingkungan server. |
Struct
HttpRequestOptionsKey<TValue> |
Mewakili kunci dalam koleksi opsi untuk permintaan HTTP. |
Antarmuka
IHttpClientFactory |
Abstraksi pabrik untuk komponen yang dapat membuat HttpClient instans dengan konfigurasi kustom untuk nama logis tertentu. |
IHttpMessageHandlerFactory |
Abstraksi pabrik untuk komponen yang dapat membuat HttpMessageHandler instans dengan konfigurasi kustom untuk nama logis tertentu. |
Enum
ClientCertificateOption |
Menentukan bagaimana sertifikat klien disediakan. |
CookieUsePolicy |
Enumerasi ini memungkinkan kontrol cookie HTTP saat berkomunikasi dengan server. |
HttpCompletionOption |
Menunjukkan apakah HttpClient operasi harus dianggap selesai baik segera setelah respons tersedia, atau setelah membaca seluruh pesan respons termasuk konten. |
HttpKeepAlivePingPolicy |
Menentukan kapan bingkai ping HTTP/2 dikirim pada koneksi diam. |
HttpRequestError |
Menentukan kategori kesalahan yang mewakili alasan untuk HttpRequestException atau HttpIOException. |
HttpVersionPolicy |
Menentukan perilaku untuk memilih dan menegosiasikan versi HTTP untuk permintaan. |
WindowsProxyUsePolicy |
Enumerasi ini menyediakan opsi yang tersedia untuk pengaturan proksi yang HttpClient digunakan oleh saat berjalan di Windows. |
Delegasikan
HeaderEncodingSelector<TContext> |
Mewakili metode yang menentukan pengodean yang akan digunakan saat menginterpretasikan nilai header. |
Keterangan
Namespace System.Net.Http dirancang untuk memberikan hal berikut:
Komponen klien HTTP yang memungkinkan pengguna untuk menggunakan layanan web modern melalui HTTP.
Komponen HTTP yang dapat digunakan oleh klien dan server (header dan pesan HTTP, misalnya). Ini menyediakan model pemrograman yang konsisten di sisi klien dan server untuk layanan web modern melalui HTTP.
Namespace System.Net.Http layanan dan namespace terkait System.Net.Http.Headers menyediakan set komponen berikut:
HttpClient - kelas utama yang digunakan untuk mengirim dan menerima permintaan melalui HTTP.
HttpRequestMessage dan HttpResponseMessage - Pesan HTTP seperti yang didefinisikan dalam RFC 2616 oleh IETF.
HttpHeaders - Header HTTP seperti yang didefinisikan dalam RFC 2616 oleh IETF.
HttpClientHandler - Handler HTTP yang bertanggung jawab untuk memproduksi pesan respons HTTP.
Ada berbagai penangan pesan HTTP yang dapat digunakan. Komponen ini meliputi hal berikut.
DelegatingHandler - Kelas yang digunakan untuk menyambungkan handler ke rantai handler.
HttpMessageHandler - Kelas sederhana untuk berasal dari yang mendukung persyaratan paling umum untuk sebagian besar aplikasi.
HttpClientHandler - Kelas yang beroperasi di bagian bawah rantai handler yang benar-benar menangani operasi transportasi HTTP.
WebRequestHandler - Kelas khusus yang beroperasi di bagian bawah kelas rantai handler yang menangani operasi transportasi HTTP dengan opsi yang khusus untuk System.Net.HttpWebRequest objek .
Konten pesan HTTP sesuai dengan isi entitas yang ditentukan dalam RFC 2616.
Sejumlah kelas dapat digunakan untuk konten HTTP. Komponen ini meliputi hal berikut.
ByteArrayContent - Konten HTTP berdasarkan array byte.
FormUrlEncodedContent - Konten HTTP dari tuple nama/nilai yang dikodekan menggunakan jenis MIME application/x-www-form-urlencoded.
MultipartContent - Konten HTTP yang diserialisasikan menggunakan spesifikasi jenis konten multipart/*.
MultipartFormDataContent - Konten HTTP dikodekan menggunakan jenis MIME multipart/form-data.
StreamContent - Konten HTTP berdasarkan aliran.
StringContent - Konten HTTP berdasarkan string.
Jika aplikasi yang menggunakan System.Net.Http namespace layanan dan System.Net.Http.Headers berniat mengunduh data dalam jumlah besar (50 megabyte atau lebih), aplikasi harus melakukan streaming unduhan tersebut dan tidak menggunakan buffering default. Jika buffering default digunakan, penggunaan memori klien akan menjadi sangat besar, berpotensi mengakibatkan performa yang berkurang secara substansial.
Kelas di System.Net.Http namespace layanan dan System.Net.Http.Headers dapat digunakan untuk mengembangkan aplikasi Bursa Windows atau aplikasi desktop. Saat digunakan dalam aplikasi Bursa Windows, kelas di System.Net.Http namespace layanan dan System.Net.Http.Headers dipengaruhi oleh fitur isolasi jaringan, bagian dari model keamanan aplikasi yang digunakan oleh Windows 8. Kemampuan jaringan yang sesuai harus diaktifkan dalam manifes aplikasi untuk aplikasi Windows Store agar sistem dapat mengizinkan akses jaringan oleh aplikasi bursa Windows. Untuk informasi selengkapnya, lihat Isolasi Jaringan untuk Aplikasi Windows Store.