System.Net.Http Ruang nama

Referensi

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.