HttpClientHandler Sınıf

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kod:

System.Net.Http.dll

Kaynak:

HttpClientHandler.cs

tarafından .NET Framework ve .NET Core 2.0 ve önceki sürümlerinde kullanılan HttpClient varsayılan ileti işleyicisi.

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

Devralma

Object

HttpMessageHandler

HttpClientHandler

Türetilmiş

System.Net.Http.WebRequestHandler

Örnekler

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();
}

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. HttpClientHandler için ek API açıklamaları.

Oluşturucular

HttpClientHandler()

Bir HttpClientHandler sınıfın örneğini oluşturur.

Özellikler

AllowAutoRedirect	İşleyicinin yeniden yönlendirme yanıtlarını izlemesi gerekip gerekmediğini belirten bir değer alır veya ayarlar.
AutomaticDecompression	İŞleyici tarafından HTTP içerik yanıtının otomatik olarak sıkıştırmasını açmak için kullanılan sıkıştırma yönteminin türünü alır veya ayarlar.
CheckCertificateRevocationList	Sertifikanın sertifika yetkilisi iptal listesinde denetlenip denetlenmediğini belirten bir değer alır veya ayarlar.
ClientCertificateOptions	Sertifikanın sertifika deposundan otomatik olarak seçildiğini veya çağıranın belirli bir istemci sertifikasını geçirmesine izin verilip verilmediğini belirten bir değer alır veya ayarlar.
ClientCertificates	Sunucuya yönelik isteklerle ilişkili güvenlik sertifikalarının koleksiyonunu alır.
CookieContainer	İşleyici tarafından sunucu tanımlama bilgilerini depolamak için kullanılan tanımlama bilgisi kapsayıcısını alır veya ayarlar.
Credentials	Bu işleyici tarafından kullanılan kimlik doğrulama bilgilerini alır veya ayarlar.
DangerousAcceptAnyServerCertificateValidator	Her zaman döndüren trueönbelleğe alınmış bir temsilci alır.
DefaultProxyCredentials	Varsayılan (sistem) ara sunucusu kullanılırken kimlik doğrulama için kimlik bilgilerini varsayılan ara sunucuya göndermek üzere alır veya ayarlar. Varsayılan proxy yalnızca UseProxy olarak ayarlandığında true ve Proxy olarak ayarlandığında nullkullanılır.
MaxAutomaticRedirections	İşleyicinin izlediği en fazla yeniden yönlendirme sayısını alır veya ayarlar.
MaxConnectionsPerServer	Bir HttpClient nesne kullanarak istekte bulunurken izin verilen en fazla eşzamanlı bağlantı sayısını (sunucu uç noktası başına) alır veya ayarlar. Sınırın sunucu uç noktası başına olduğuna dikkat edin, bu nedenle örneğin 256 değeri ile 256 eş zamanlı bağlantıya http://www.adatum.com/ ve başka bir 256'ya http://www.adventure-works.com/izin verir.
MaxRequestContentBufferSize	İşleyici tarafından kullanılan en büyük istek içeriği arabellek boyutunu alır veya ayarlar.
MaxResponseHeadersLength	Yanıt üst bilgilerinin kilobayt (1024 bayt) cinsinden uzunluk üst sınırını alır veya ayarlar. Örneğin, değer 64 ise, maksimum yanıt üst bilgilerinin uzunluğu için 65536 bayta izin verilir.
MeterFactory	Örneği için özel Meter oluşturmak üzere HttpClientHandler öğesini alır veya ayarlarIMeterFactory.
PreAuthenticate	İşleyicinin istekle bir Yetkilendirme üst bilgisi gönderip göndermediğini belirten bir değer alır veya ayarlar.
Properties	İstekler için özel özelliklerin yazılabilir bir sözlüğünü (yani bir eşlemeyi HttpClient ) alır. Sözlük boş başlatılır; özel işleyicileriniz ve özel işlemeniz için anahtar-değer çiftleri ekleyebilir ve sorgulayabilirsiniz.
Proxy	İşleyici tarafından kullanılan ara sunucu bilgilerini alır veya ayarlar.
ServerCertificateCustomValidationCallback	Sunucu sertifikasını doğrulamak için bir geri çağırma yöntemi alır veya ayarlar.
SslProtocols	HttpClientHandler nesnesi tarafından yönetilen nesneler tarafından HttpClient kullanılan TLS/SSL protokollerini alır veya ayarlar.
SupportsAutomaticDecompression	İşleyicinin otomatik yanıt içeriği açma işlemini destekleyip desteklemediğini belirten bir değer alır.
SupportsProxy	İşleyicinin ara sunucu ayarlarını destekleyip desteklemediğini gösteren bir değer alır.
SupportsRedirectConfiguration	İşleyicinin ve MaxAutomaticRedirections özellikleri için AllowAutoRedirect yapılandırma ayarlarını destekleyip desteklemediğini gösteren bir değer alır.
UseCookies	İşleyicinin sunucu tanımlama bilgilerini depolamak için özelliğini kullanıp kullanmadığını CookieContainer ve istek gönderirken bu tanımlama bilgilerini kullanıp kullanmadığını belirten bir değer alır veya ayarlar.
UseDefaultCredentials	varsayılan kimlik bilgilerinin işleyici tarafından isteklerle gönderilip gönderilmediğini denetleen bir değer alır veya ayarlar.
UseProxy	İşleyicinin istekler için ara sunucu kullanıp kullanmadığını belirten bir değer alır veya ayarlar.

Yöntemler

Dispose()	Yönetilmeyen kaynakları serbest bırakır ve tarafından HttpMessageHandlerkullanılan yönetilen kaynakları atılır. (Devralındığı yer: HttpMessageHandler)
Dispose(Boolean)	tarafından HttpClientHandler kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları atılır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Send(HttpRequestMessage, CancellationToken)	içinde HttpRequestMessagesağlanan bilgilere göre bir örneği HttpResponseMessage oluşturur.
SendAsync(HttpRequestMessage, CancellationToken)	engellemeyecek bir işlem olarak içinde HttpRequestMessage sağlanan bilgileri temel alan bir örneği HttpResponseMessage oluşturur.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Web hizmetine bağlanma
• Hızlı Başlangıç: HttpClient kullanarak bağlanma
• HttpClient işleyicilerini kullanma
• HttpClient bağlantılarının güvenliğini sağlama
• HttpClient Örneği