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
| Name | Description |
|---|---|
| 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 |
URI tarafından tanımlanan bir kaynaktan HTTP istekleri göndermek ve HTTP yanıtları almak için bir sınıf sağlar. |
| HttpClientFactoryExtensions |
için IHttpClientFactoryuzantı yöntemleri. |
| HttpClientHandler |
.NET Framework ve .NET Core 2.0 ve önceki sürümlerinde tarafından HttpClient kullanılan 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 temel tür. |
| HttpMessageHandlerFactoryExtensions |
için IHttpMessageHandlerFactoryuzantı yöntemleri. |
| HttpMessageInvoker |
Uygulamaların http işleyici zincirinde SendAsync(HttpRequestMessage, CancellationToken) yöntemini çağırmasına olanak tanıyan 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 |
İstek ve/veya yanıt iletilerinin yalnızca bazı küçük işlemlerini yapan işleyiciler için temel tür. |
| MultipartContent |
Çok bölümlü/* 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 |
Bir SocketsHttpHandler örneğine 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 |
YuvahttpHandler ö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ılmak üzere tasarlanmıştır. |
Yapılar
| Name | Description |
|---|---|
| HttpRequestOptionsKey<TValue> |
HTTP isteği için seçenekler koleksiyonundaki bir anahtarı temsil eder. |
Arabirimler
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| 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 işlemlerinin, yanıt kullanılabilir olduğunda veya içerik dahil tüm yanıt iletisi okundıktan sonra tamamlandığının kabul edilmesi gerekip gerekmediğini gösterir. |
| HttpKeepAlivePingPolicy |
Boşta bağlantıda HTTP/2 ping çerçevesinin ne zaman gönderileceğini belirtir. |
| HttpRequestError |
HttpRequestException veya HttpIOExceptionnedenini 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 bir HttpClient tarafından kullanılan ara sunucu ayarları için kullanılabilir seçenekler sağlar. |
Temsilciler
| Name | Description |
|---|---|
| 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ğıdaki bileşenleri 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 ve 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 iletileri üretmekten sorumlu HTTP işleyicileri.
Kullanabileceğiniz çeşitli HTTP ileti işleyicileri vardır:
- 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.
HTTP iletisinin içeriği RFC 2616'da tanımlanan varlık gövdesine karşılık gelir.
HTTP içeriği için aşağıdaki sınıflar kullanılabilir:
- 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 bölümlü/* 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 - Dizeye dayalı HTTP içeriği.
Uygulamanız ve System.Net.Http.Headers ad alanlarını kullanıyorsa System.Net.Http ve büyük miktarda veri (50 megabayt veya daha fazla) indirmeyi planlıyorsa, bu indirmelerin akışını yapmalı ve varsayılan arabelleğe almayı kullanmamalıdır. Varsayılan arabelleğe almayı kullanırsanız, istemcinin bellek kullanımı aşırı artar ve bu da performansın önemli ölçüde düşmesine yol açabilir.
