WinHttpHandler Kelas

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.WinHttpHandler.dll

Paket:

System.Net.Http.WinHttpHandler v8.0.0

Sumber:

WinHttpHandler.cs

Menangani pesan berdasarkan antarmuka WinHTTP Windows. Kelas ini ditujukan untuk digunakan di lingkungan server.

public ref class WinHttpHandler : System::Net::Http::HttpMessageHandler

public class WinHttpHandler : System.Net.Http.HttpMessageHandler

type WinHttpHandler = class
    inherit HttpMessageHandler

Public Class WinHttpHandler
Inherits HttpMessageHandler

Warisan

Object

HttpMessageHandler

WinHttpHandler

Keterangan

WinHttpHandler mirip dengan kelas lain yang ada seperti HttpClientHandler. WinHttpHandler menyediakan handler di bawah HttpClient instans dan digunakan untuk mengirim permintaan HTTP ke server dan menerima respons server. Implementasi WinHttpHandler ini mendukung versi HTTP hingga HTTP/2.

WinHttpHandler dirancang untuk digunakan terutama di lingkungan server oleh ASP.NET Core dan aplikasi .NET lainnya yang berkomunikasi dengan server HTTP. WinHttpHandler juga memberi pengembang kontrol yang lebih terperinci atas komunikasi HTTP aplikasi daripada HttpClientHandler kelas . Ini memungkinkan pengembang untuk menerapkan skenario HTTP yang lebih canggih atau memodifikasi default sistem (misalnya, pengaturan proksi, batas waktu, dan validasi sertifikat SSL server).

WinHttpHandlertidak dimaksudkan untuk menjadi pengganti .HttpClientHandler Sebaliknya, ini adalah versi yang lebih canggih yang disediakan untuk skenario di mana HttpClientHandler tidak cukup. WinHttpHandler diimplementasikan sebagai pembungkus tipis pada antarmuka WinHTTP Windows dan hanya didukung pada sistem Windows.

Saat menggunakan rantai beberapa handler, WinHttpHandler harus berada di bagian bawah rantai.

Kelas ini juga tersedia untuk digunakan di aplikasi Desktop dengan menginstalnya sebagai paket NuGet. Untuk informasi selengkapnya, lihat Paket NuGet System.Net.Http.WinHttpHandler.

Mulai dari .NET 5, WinHttpHandler tidak lagi disertakan dalam perakitanSystem.Net.Http.dll sebagai bagian dari runtime .NET. Untuk informasi selengkapnya, lihat WinHttpHandler dihapus dari runtime .NET.

Konstruktor

WinHttpHandler()

Menginisialisasi instans baru kelas WinHttpHandler.

Properti

AutomaticDecompression	Mendapatkan atau mengatur jenis metode dekompresi yang digunakan oleh handler untuk dekompresi otomatis respons konten HTTP.
AutomaticRedirection	Mendapatkan atau menetapkan nilai yang menunjukkan apakah handler harus mengikuti respons pengalihan HTTP.
CheckCertificateRevocationList	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan memeriksa daftar pencabutan sertifikat selama validasi sertifikat SSL.
ClientCertificateOption	Mendapatkan atau menetapkan nilai yang menunjukkan apakah sertifikat secara otomatis dipilih dari penyimpanan sertifikat atau jika pemanggil diizinkan untuk meneruskan sertifikat klien tertentu.
ClientCertificates	Mendapatkan kumpulan sertifikat SSL autentikasi klien yang digunakan untuk autentikasi klien oleh handler jika ClientCertificateOption properti diatur ke Manual.
CookieContainer	Mendapatkan atau mengatur objek kontainer cookie terkelola. Properti ini hanya digunakan ketika CookieUsePolicy properti diatur ke UseSpecifiedCookieContainer. Jika tidak, SendAsync(HttpRequestMessage, CancellationToken) metode akan memberikan pengecualian.
CookieUsePolicy	Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana cookie harus dikelola dan digunakan. Pengembang dapat memilih untuk mengabaikan cookie, memungkinkan handler untuk mengelolanya secara otomatis atau menanganinya secara manual menggunakan CookieContainer objek .
DefaultProxyCredentials	Mendapatkan atau mengatur kredensial yang digunakan untuk mengautentikasi pengguna ke proksi autentikasi.
EnableMultipleHttp2Connections	Mendapatkan atau menetapkan nilai yang menunjukkan apakah koneksi HTTP/2 tambahan dapat dibuat ke server yang sama ketika jumlah maksimum aliran bersamaan tercapai pada semua koneksi yang ada.
MaxAutomaticRedirections	Mendapatkan atau mengatur jumlah maksimum pengalihan HTTP yang diizinkan.
MaxConnectionsPerServer	Mendapatkan atau mengatur jumlah maksimum koneksi TCP yang diizinkan ke satu server.
MaxResponseDrainSize	Mendapatkan atau mengatur jumlah maksimum data yang dapat dikosongkan dari respons dalam byte.
MaxResponseHeadersLength	Mendapatkan atau mengatur ukuran maksimum bagian header dari respons server dalam byte.
PreAuthenticate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah handler mengirim header Otorisasi dengan permintaan.
Properties	Mendapatkan kamus yang dapat ditulis (yaitu, peta) properti kustom untuk permintaan.HttpClient Kamus diinisialisasi kosong; Anda dapat menyisipkan dan mengkueri pasangan kunci-nilai untuk handler kustom dan pemrosesan khusus Anda.
Proxy	Mendapatkan atau mengatur proksi kustom saat WindowsProxyUsePolicy properti diatur untuk menggunakan proksi kustom.
ReceiveDataTimeout	Mendapatkan atau mengatur batas waktu untuk menerima bagian data respons dari server.
ReceiveHeadersTimeout	Mendapatkan atau mengatur batas waktu untuk menerima header respons dari server.
SendTimeout	Mendapatkan atau mengatur batas waktu untuk mengirim permintaan.
ServerCertificateValidationCallback	Mendapatkan atau mengatur metode panggilan balik untuk memvalidasi sertifikat server. Panggilan balik ini adalah bagian dari jabat tangan SSL.
ServerCredentials	Mendapatkan atau mengatur kredensial yang akan digunakan oleh klien untuk mengautentikasi ke server.
SslProtocols	Mendapatkan atau mengatur kumpulan protokol TLS/SSL yang didukung oleh klien.
TcpKeepAliveEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah TCP tetap aktif.
TcpKeepAliveInterval	Mendapatkan atau mengatur interval TCP keep-alive.
TcpKeepAliveTime	Mendapatkan atau mengatur batas waktu TCP tetap aktif.
WindowsProxyUsePolicy	Mendapatkan atau mengatur pengaturan proksi. Properti ini dapat diatur untuk menonaktifkan proksi, menggunakan proksi kustom, atau menggunakan pengaturan proksi WinHTTP atau WinInet pada komputer.

Metode

Dispose()	Merilis sumber daya yang tidak dikelola dan membuang sumber daya terkelola yang digunakan oleh HttpMessageHandler. (Diperoleh dari HttpMessageHandler)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh WinHttpHandler, dan secara opsional membuang sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Send(HttpRequestMessage, CancellationToken)	Ketika ditimpa di kelas turunan, mengirim permintaan HTTP dengan token permintaan dan pembatalan yang ditentukan. Jika tidak, melempar NotSupportedException. (Diperoleh dari HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	Mengirim permintaan HTTP sebagai operasi asinkron.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)