Bagikan melalui


HttpClientHandler Kelas

Definisi

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
HttpClientHandler
Turunan

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.

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)

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)

Berlaku untuk

Lihat juga