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
| Nama | Deskripsi |
|---|---|
| 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 dalam .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 tipe 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 handler 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 Windows Store atau lingkungan lainnya. |
| WinHttpHandler |
Menangani pesan berdasarkan antarmuka WinHTTP Windows. Kelas ini ditujukan untuk digunakan di lingkungan server. |
Struct
| Nama | Deskripsi |
|---|---|
| HttpRequestOptionsKey<TValue> |
Mewakili kunci dalam koleksi opsi untuk permintaan HTTP. |
Antarmuka
| Nama | Deskripsi |
|---|---|
| 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
| Nama | Deskripsi |
|---|---|
| ClientCertificateOption |
Menentukan bagaimana sertifikat klien disediakan. |
| CookieUsePolicy |
Enumerasi ini memungkinkan kontrol cookie HTTP saat berkomunikasi dengan server. |
| HttpCompletionOption |
Menunjukkan apakah operasi HttpClient harus dianggap selesai 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 digunakan oleh HttpClient saat berjalan di Windows. |
Delegasikan
| Nama | Deskripsi |
|---|---|
| HeaderEncodingSelector<TContext> |
Mewakili metode yang menentukan pengodean yang akan digunakan saat menginterpretasikan nilai header. |
Keterangan
Namespace System.Net.Http dirancang untuk menyediakan komponen berikut:
- Komponen klien HTTP yang memungkinkan pengguna untuk menggunakan layanan web modern melalui HTTP.
- Komponen HTTP yang dapat digunakan oleh klien dan server (header http dan pesan, 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 sekumpulan 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 Anda gunakan:
- 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.
Konten pesan HTTP sesuai dengan isi entitas yang ditentukan dalam RFC 2616.
Kelas berikut dapat digunakan untuk konten HTTP:
- 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 Anda menggunakan System.Net.Http namespace layanan dan System.Net.Http.Headers ingin mengunduh data dalam jumlah besar (50 megabyte atau lebih), aplikasi tersebut harus melakukan streaming unduhan tersebut dan tidak menggunakan buffering default. Jika Anda menggunakan buffering default, penggunaan memori klien akan menjadi sangat besar, berpotensi mengakibatkan performa yang berkurang secara substansial.
