HttpClientHandler Kelas

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

Sumber:

HttpClientHandler.cs

Handler pesan default yang digunakan oleh HttpClient di .NET Framework dan .NET Core 2.0 dan yang lebih lama.

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

public class HttpClientHandler : System.Net.Http.HttpMessageHandler

type HttpClientHandler = class
    inherit HttpMessageHandler

Public Class HttpClientHandler
Inherits HttpMessageHandler

Warisan

Object

HttpMessageHandler

HttpClientHandler

Turunan

System.Net.Http.WebRequestHandler

Contoh

static async Task Main()
{
   // Create an HttpClientHandler object and set to use default credentials
   HttpClientHandler handler = new HttpClientHandler();
   handler.UseDefaultCredentials = true;

   // Create an HttpClient object
   HttpClient client = new HttpClient(handler);

   // Call asynchronous network methods in a try/catch block to handle exceptions
   try
   {
      HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");

      response.EnsureSuccessStatusCode();

      string responseBody = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseBody);
   }
   catch(HttpRequestException e)
   {
       Console.WriteLine("\nException Caught!");
       Console.WriteLine("Message :{0} ",e.Message);
   }

   // Need to call dispose on the HttpClient and HttpClientHandler objects
   // when done using them, so the app doesn't leak resources
   handler.Dispose();
   client.Dispose();
}

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk HttpClientHandler.

Konstruktor

HttpClientHandler()

Membuat instans HttpClientHandler kelas.

Properti

AllowAutoRedirect	Mendapatkan atau menetapkan nilai yang menunjukkan apakah handler harus mengikuti respons pengalihan.
AutomaticDecompression	Mendapatkan atau mengatur jenis metode dekompresi yang digunakan oleh handler untuk dekompresi otomatis respons konten HTTP.
CheckCertificateRevocationList	Mendapatkan atau menetapkan nilai yang menunjukkan apakah sertifikat diperiksa terhadap daftar pencabutan otoritas sertifikat.
ClientCertificateOptions	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 keamanan yang terkait dengan permintaan ke server.
CookieContainer	Mendapatkan atau mengatur kontainer cookie yang digunakan untuk menyimpan cookie server oleh handler.
Credentials	Mendapatkan atau mengatur informasi autentikasi yang digunakan oleh handler ini.
DangerousAcceptAnyServerCertificateValidator	Mendapatkan delegasi cache yang selalu mengembalikan true.
DefaultProxyCredentials	Ketika proksi default (sistem) sedang digunakan, mendapatkan atau mengatur kredensial untuk dikirimkan ke server proksi default untuk autentikasi. Proksi default hanya digunakan ketika UseProxy diatur ke true dan Proxy diatur ke null.
MaxAutomaticRedirections	Mendapatkan atau mengatur jumlah maksimum pengalihan yang diikuti penangan.
MaxConnectionsPerServer	Mendapatkan atau mengatur jumlah maksimum koneksi bersamaan (per titik akhir server) yang diizinkan saat membuat permintaan menggunakan HttpClient objek. Perhatikan bahwa batasnya adalah per titik akhir server, jadi misalnya nilai 256 akan mengizinkan 256 koneksi bersamaan ke http://www.adatum.com/ dan 256 lainnya ke http://www.adventure-works.com/.
MaxRequestContentBufferSize	Mendapatkan atau mengatur ukuran buffer konten permintaan maksimum yang digunakan oleh handler.
MaxResponseHeadersLength	Mendapatkan atau mengatur panjang maksimum, dalam kilobyte (1024 byte), dari header respons. Misalnya, jika nilainya adalah 64, maka 65536 byte diizinkan untuk panjang header respons maksimum.
MeterFactory	Mendapatkan atau mengatur IMeterFactory untuk membuat kustom Meter untuk HttpClientHandler instans.
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 informasi proksi yang digunakan oleh handler.
ServerCertificateCustomValidationCallback	Mendapatkan atau mengatur metode panggilan balik untuk memvalidasi sertifikat server.
SslProtocols	Mendapatkan atau mengatur protokol TLS/SSL yang digunakan oleh objek yang HttpClient dikelola oleh objek HttpClientHandler.
SupportsAutomaticDecompression	Mendapatkan nilai yang menunjukkan apakah handler mendukung dekompresi konten respons otomatis.
SupportsProxy	Mendapatkan nilai yang menunjukkan apakah handler mendukung pengaturan proksi.
SupportsRedirectConfiguration	Mendapatkan nilai yang menunjukkan apakah handler mendukung pengaturan konfigurasi untuk AllowAutoRedirect properti dan MaxAutomaticRedirections .
UseCookies	Mendapatkan atau menetapkan nilai yang menunjukkan apakah handler menggunakan CookieContainer properti untuk menyimpan cookie server dan menggunakan cookie ini saat mengirim permintaan.
UseDefaultCredentials	Mendapatkan atau menetapkan nilai yang mengontrol apakah kredensial default dikirim dengan permintaan oleh handler.
UseProxy	Mendapatkan atau menetapkan nilai yang menunjukkan apakah handler menggunakan proksi untuk permintaan.

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 HttpClientHandler 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)	Membuat instans HttpResponseMessage berdasarkan informasi yang disediakan di HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Membuat instans HttpResponseMessage berdasarkan informasi yang disediakan dalam HttpRequestMessage sebagai operasi yang tidak akan diblokir.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Menyambungkan ke layanan web
• Mulai cepat: Menyambungkan menggunakan HttpClient
• Cara menggunakan handler HttpClient
• Cara mengamankan koneksi HttpClient
• Sampel HttpClient