Aracılığıyla paylaş


HttpClientHandler Sınıf

Tanım

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
HttpClientHandler
Türetilmiş

Ö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.

Send(HttpRequestMessage, CancellationToken)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen istek ve iptal belirteciyle bir HTTP isteği gönderir. Aksi takdirde, bir NotSupportedExceptionoluşturur.

(Devralındığı yer: HttpMessageHandler)
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)

Şunlara uygulanır

Ayrıca bkz.