System.Net.Http Ad Alanı
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Modern HTTP uygulamaları için bir programlama arabirimi sağlar.
Sınıflar
ByteArrayContent |
Bayt dizisine dayalı HTTP içeriği sağlar. |
DelegatingHandler |
HTTP yanıt iletilerinin işlenmesini iç işleyici olarak adlandırılan başka bir işleyiciye devreden HTTP işleyicileri için bir tür. |
FormUrlEncodedContent |
application/x-www-form-urlencoded MIME türü kullanılarak kodlanmış ad/değer demetleri için bir kapsayıcı. |
HttpClient |
HTTP istekleri göndermek ve URI ile tanımlanan bir kaynaktan HTTP yanıtları almak için bir sınıf sağlar. |
HttpClientFactoryExtensions |
için IHttpClientFactoryuzantı yöntemleri. |
HttpClientHandler |
tarafından .NET Framework ve .NET Core 2.0 ve önceki sürümlerinde kullanılan HttpClient varsayılan ileti işleyicisi. |
HttpContent |
HTTP varlık gövdesini ve içerik üst bilgilerini temsil eden temel sınıf. |
HttpDiagnosticsHttpRequestMessageExtensions |
Telemetri yardımcı programları için uzantılar. |
HttpIOException |
Yanıt okunurken bir hata oluştuğunda oluşan özel durum. |
HttpMessageHandler |
HTTP ileti işleyicileri için bir temel tür. |
HttpMessageHandlerFactoryExtensions |
için IHttpMessageHandlerFactoryuzantı yöntemleri. |
HttpMessageInvoker |
Uygulamaların bir HTTP işleyici zincirinde yöntemini çağırmasına SendAsync(HttpRequestMessage, CancellationToken) izin veren bir özel sınıf. |
HttpMethod |
Standart HTTP yöntemlerini almak ve karşılaştırmak ve yeni HTTP yöntemleri oluşturmak için yardımcı sınıf. |
HttpProtocolException |
HTTP/2 veya HTTP/3 protokolü hatası oluştuğunda oluşan özel durum. |
HttpRequestException |
ve HttpMessageHandler sınıfları tarafından HttpClient oluşan özel durumlar için bir temel sınıf. |
HttpRequestMessage |
HTTP isteği iletisini temsil eder. |
HttpRequestOptions |
HTTP isteği için bir seçenek koleksiyonunu temsil eder. |
HttpResilienceHttpRequestMessageExtensions |
için HttpRequestMessagedayanıklılık uzantıları. |
HttpResponseMessage |
Durum kodu ve verileri içeren bir HTTP yanıt iletisini temsil eder. |
MessageProcessingHandler |
yalnızca istek ve/veya yanıt iletilerinin küçük bir kısmını işleyen işleyiciler için bir temel tür. |
MultipartContent |
Çok parçalı/* içerik türü belirtimi kullanılarak seri hale getirilen bir nesne koleksiyonu HttpContent sağlar. |
MultipartFormDataContent |
Çok parçalı/form-veri MIME türü kullanılarak kodlanmış içerik için bir kapsayıcı sağlar. |
ReadOnlyMemoryContent |
bir ReadOnlyMemory<T>tabanlı HTTP içeriği sağlar. |
RtcRequestFactory |
Modern HTTP uygulamaları için bir programlama arabirimi sağlar. |
SocketsHttpConnectionContext |
Örneği SocketsHttpHandler için öğesine geçirilen bağlamı ConnectCallback temsil eder. . |
SocketsHttpHandler |
tarafından .NET Core 2.1 ve sonraki sürümlerde kullanılan HttpClient varsayılan ileti işleyicisini sağlar. |
SocketsHttpPlaintextStreamFilterContext |
SocketsHttpHandler örneği için PlaintextStreamFilter'a geçirilen bağlamı temsil eder. |
StreamContent |
Bir akışı temel alan HTTP içeriği sağlar. |
StringContent |
Bir dizeyi temel alan HTTP içeriği sağlar. |
WebRequestHandler |
Windows Mağazası uygulamaları veya diğer ortamlar için kullanılamayan masaüstüne özgü özellikler sağlar. |
WinHttpHandler |
İletileri Windows'un WinHTTP arabirimine göre işler. Bu sınıf, sunucu ortamlarında kullanım için tasarlanmıştır. |
Yapılar
HttpRequestOptionsKey<TValue> |
HTTP isteği için seçenekler koleksiyonundaki bir anahtarı temsil eder. |
Arabirimler
IHttpClientFactory |
Belirli bir mantıksal ad için özel yapılandırmaya sahip örnekler oluşturabilen HttpClient bir bileşen için fabrika soyutlaması. |
IHttpMessageHandlerFactory |
Belirli bir mantıksal ad için özel yapılandırmaya sahip örnekler oluşturabilen HttpMessageHandler bir bileşen için fabrika soyutlaması. |
Numaralandırmalar
ClientCertificateOption |
İstemci sertifikalarının nasıl sağlandığını belirtir. |
CookieUsePolicy |
Bu numaralandırma, sunucuyla iletişim kurarken HTTP tanımlama bilgilerinin denetlenmesini sağlar. |
HttpCompletionOption |
HttpClient İşlemlerin yanıt kullanılabilir olduğunda veya içerik de dahil olmak üzere yanıt iletisinin tamamını okuduktan sonra tamamlandığının düşünülmesi gerektiğini gösterir. |
HttpKeepAlivePingPolicy |
Boşta bağlantıda HTTP/2 ping çerçevesinin ne zaman gönderileceğini belirtir. |
HttpRequestError |
veya HttpIOExceptionnedenini HttpRequestException temsil eden hata kategorilerini tanımlar. |
HttpVersionPolicy |
İstek için HTTP sürümünü seçme ve anlaşma davranışlarını belirtir. |
WindowsProxyUsePolicy |
Bu numaralandırma, Windows üzerinde çalışırken tarafından HttpClient kullanılan ara sunucu ayarları için kullanılabilir seçenekler sağlar. |
Temsilciler
HeaderEncodingSelector<TContext> |
Üst bilgi değerlerini yorumlarken kullanılacak kodlamayı belirten bir yöntemi temsil eder. |
Açıklamalar
Ad System.Net.Http alanı aşağıdakileri sağlayacak şekilde tasarlanmıştır:
Kullanıcıların HTTP üzerinden modern web hizmetlerini kullanmasına olanak sağlayan HTTP istemci bileşenleri.
hem istemciler hem de sunucular tarafından kullanılabilen HTTP bileşenleri (örneğin, HTTP üst bilgileri ve iletileri). Bu, HTTP üzerinden modern web hizmetleri için hem istemci hem de sunucu tarafında tutarlı bir programlama modeli sağlar.
Ad System.Net.Http alanı ve ilgili System.Net.Http.Headers ad alanı aşağıdaki bileşen kümesini sağlar:
HttpClient - HTTP üzerinden istek göndermek ve almak için kullanılan birincil sınıf.
HttpRequestMessage and HttpResponseMessage - IETF tarafından RFC 2616'da tanımlanan HTTP iletileri.
HttpHeaders - IETF tarafından RFC 2616'da tanımlanan HTTP üst bilgileri.
HttpClientHandler - HTTP yanıt iletilerini üretmekten sorumlu HTTP işleyicileri.
Kullanılabilecek çeşitli HTTP ileti işleyicileri vardır. Bunlar aşağıdakileri içerir.
DelegatingHandler - İşleyiciyi işleyici zincirine bağlamak için kullanılan bir sınıf.
HttpMessageHandler - Çoğu uygulama için en yaygın gereksinimleri destekleyen, türetilen basit bir sınıf.
HttpClientHandler - İŞleyici zincirinin en altında çalışan ve HTTP aktarım işlemlerini işleyen bir sınıf.
WebRequestHandler - HTTP taşıma işlemlerini nesneye özgü System.Net.HttpWebRequest seçeneklerle işleyen işleyici zinciri sınıfının en altında çalışan bir özel sınıf.
HTTP iletisinin içeriği, RFC 2616'da tanımlanan varlık gövdesine karşılık gelir.
HTTP içeriği için bir dizi sınıf kullanılabilir. Bunlar aşağıdakileri içerir.
ByteArrayContent - Bayt dizisine dayalı HTTP içeriği.
FormUrlEncodedContent - application/x-www-form-urlencoded MIME türü kullanılarak kodlanmış ad/değer demetlerinin HTTP içeriği.
MultipartContent - Çok parçalı/* içerik türü belirtimi kullanılarak seri hale getirilen HTTP içeriği.
MultipartFormDataContent - Çok parçalı/form-veri MIME türü kullanılarak kodlanmış HTTP içeriği.
StreamContent - Akışa dayalı HTTP içeriği.
StringContent - Bir dizeyi temel alan HTTP içeriği.
ve System.Net.Http.Headers ad alanlarını kullanan System.Net.Http bir uygulama büyük miktarlarda (50 megabayt veya daha fazla) veri indirmeyi planlıyorsa, uygulamanın bu indirmeleri akışla aktarması ve varsayılan arabelleğe almayı kullanmaması gerekir. Varsayılan arabelleğe alma kullanılırsa istemci bellek kullanımı çok büyük olur ve bu da performansın önemli ölçüde düşmesine neden olabilir.
ve System.Net.Http.Headers ad alanları içindeki System.Net.Http sınıflar, Windows Mağazası uygulamaları veya masaüstü uygulamaları geliştirmek için kullanılabilir. Bir Windows Mağazası uygulamasında kullanıldığında ve System.Net.Http.Headers ad alanları içindeki System.Net.Http sınıflar, Windows 8 tarafından kullanılan uygulama güvenlik modelinin bir parçası olan ağ yalıtımı özelliğinden etkilenir. Bir Windows mağazası uygulaması tarafından ağ erişimine izin vermek için sistem için bir Windows Mağazası uygulaması için uygulama bildiriminde uygun ağ özellikleri etkinleştirilmelidir. Daha fazla bilgi için bkz. Windows Mağazası Uygulamaları için Ağ Yalıtımı.