System.Net.Http Przestrzeń nazw

Udostępnia interfejs programowania dla nowoczesnych aplikacji HTTP.

Klasy

ByteArrayContent	Udostępnia zawartość HTTP na podstawie tablicy bajtów.
DelegatingHandler	Typ procedur obsługi HTTP, które delegować przetwarzanie komunikatów odpowiedzi HTTP do innej procedury obsługi, nazywanej wewnętrzną procedurą obsługi.
FormUrlEncodedContent	Kontener dla krotki nazwy/wartości zakodowany przy użyciu typu MIME z kodowaniem application/x-www-form-url.
HttpClient	Udostępnia klasę do wysyłania żądań HTTP i odbierania odpowiedzi HTTP z zasobu zidentyfikowanego przez identyfikator URI.
HttpClientHandler	Domyślna procedura obsługi komunikatów używana HttpClient w programach .NET Framework i .NET Core 2.0 i starszych.
HttpContent	Klasa bazowa reprezentująca treść jednostki HTTP i nagłówki zawartości.
HttpIOException	Wyjątek zgłaszany w przypadku wystąpienia błędu podczas odczytywania odpowiedzi.
HttpMessageHandler	Podstawowy typ procedur obsługi komunikatów HTTP.
HttpMessageInvoker	Specjalna klasa, która umożliwia aplikacjom wywoływanie metody w SendAsync(HttpRequestMessage, CancellationToken) łańcuchu obsługi HTTP.
HttpMethod	Klasa pomocnika do pobierania i porównywania standardowych metod HTTP oraz tworzenia nowych metod HTTP.
HttpProtocolException	Wyjątek zgłaszany, gdy wystąpi błąd protokołu HTTP/2 lub HTTP/3.
HttpRequestException	Klasa bazowa dla wyjątków zgłaszanych przez HttpClient klasy i HttpMessageHandler .
HttpRequestMessage	Reprezentuje komunikat żądania HTTP.
HttpRequestOptions	Reprezentuje kolekcję opcji żądania HTTP.
HttpResponseMessage	Reprezentuje komunikat odpowiedzi HTTP, w tym kod stanu i dane.
MessageProcessingHandler	Podstawowy typ procedur obsługi, które wykonują tylko małe przetwarzanie komunikatów żądań i/lub odpowiedzi.
MultipartContent	Udostępnia kolekcję HttpContent obiektów, które są serializowane przy użyciu specyfikacji typu zawartości multipart/*.
MultipartFormDataContent	Udostępnia kontener do zawartości zakodowanej przy użyciu wieloczęściowego/typu MIME danych formularzy.
ReadOnlyMemoryContent	Udostępnia zawartość HTTP na podstawie elementu ReadOnlyMemory<T>.
SocketsHttpConnectionContext	Reprezentuje kontekst przekazany do ConnectCallbackSocketsHttpHandler wystąpienia. .
SocketsHttpHandler	Udostępnia domyślną procedurę obsługi komunikatów używaną w HttpClient programie .NET Core 2.1 lub nowszym.
SocketsHttpPlaintextStreamFilterContext	Reprezentuje kontekst przekazany do klasy PlaintextStreamFilter dla wystąpienia socketsHttpHandler.
StreamContent	Udostępnia zawartość HTTP na podstawie strumienia.
StringContent	Udostępnia zawartość HTTP na podstawie ciągu.

Struktury

HttpRequestOptionsKey<TValue>

Reprezentuje klucz w kolekcji opcji dla żądania HTTP.

Wyliczenia

ClientCertificateOption	Określa sposób zapewniania certyfikatów klienta.
HttpCompletionOption	Wskazuje, czy HttpClient operacje powinny zostać uznane za ukończone, gdy tylko odpowiedź jest dostępna, lub po przeczytaniu całego komunikatu odpowiedzi, w tym zawartości.
HttpKeepAlivePingPolicy	Określa, kiedy ramka ping HTTP/2 jest wysyłana na bezczynne połączenie.
HttpRequestError	Definiuje kategorie błędów reprezentujące przyczynę HttpRequestException błędu lub HttpIOException.
HttpVersionPolicy	Określa zachowania dotyczące wybierania i negocjowania wersji protokołu HTTP dla żądania.

Delegaci

HeaderEncodingSelector<TContext>

Reprezentuje metodę określającą kodowanie do użycia podczas interpretowania wartości nagłówka.

Uwagi

Przestrzeń nazw została zaprojektowana System.Net.Http w celu zapewnienia następujących elementów:

1. Składniki klienta HTTP, które umożliwiają użytkownikom korzystanie z nowoczesnych usług internetowych za pośrednictwem protokołu HTTP.

2. Składniki HTTP, które mogą być używane zarówno przez klientów, jak i serwery (na przykład nagłówki HTTP i komunikaty). Zapewnia to spójny model programowania zarówno po stronie klienta, jak i serwera dla nowoczesnych usług internetowych za pośrednictwem protokołu HTTP.

System.Net.Http Przestrzeń nazw i powiązana System.Net.Http.Headers przestrzeń nazw udostępniają następujący zestaw składników:

1. HttpClient — klasa podstawowa używana do wysyłania i odbierania żądań za pośrednictwem protokołu HTTP.

2. HttpRequestMessage i HttpResponseMessage — komunikaty HTTP zdefiniowane w dokumencie RFC 2616 przez IETF.

3. HttpHeaders - Nagłówki HTTP zdefiniowane w RFC 2616 przez IETF.

4. HttpClientHandler — Programy obsługi HTTP odpowiedzialne za tworzenie komunikatów odpowiedzi HTTP.

Istnieją różne programy obsługi komunikatów HTTP, których można użyć. Należą do nich następujące elementy.

1. DelegatingHandler - Klasa używana do podłączania procedury obsługi do łańcucha obsługi.

2. HttpMessageHandler — Prosta klasa, która pochodzi z tej klasy, obsługuje najbardziej typowe wymagania dla większości aplikacji.

3. HttpClientHandler - Klasa, która działa w dolnej części łańcucha obsługi, która rzeczywiście obsługuje operacje transportu HTTP.

4. WebRequestHandler - Klasa specjalna, która działa w dolnej części klasy łańcucha obsługi, która obsługuje operacje transportu HTTP z opcjami specyficznymi dla System.Net.HttpWebRequest obiektu.

Zawartość komunikatu HTTP odpowiada treści jednostki zdefiniowanej w dokumencie RFC 2616.

Do obsługi zawartości HTTP można użyć wielu klas. Należą do nich następujące elementy.

1. ByteArrayContent - Zawartość HTTP oparta na tablicy bajtów.

2. FormUrlEncodedContent - Zawartość HTTP krotki nazwy/wartości zakodowana przy użyciu typu MIME z kodowaniem application/x-www-form-url.

3. MultipartContent - Zawartość HTTP, która jest serializowana przy użyciu specyfikacji typu zawartości multipart/*.

4. MultipartFormDataContent - Zawartość HTTP zakodowana przy użyciu wieloczęściowego/formularza-danych TYPU MIME.

5. StreamContent - Zawartość HTTP oparta na strumieniu.

6. StringContent - Zawartość HTTP oparta na ciągu.

Jeśli aplikacja korzystająca z System.Net.Http przestrzeni nazw i System.Net.Http.Headers zamierza pobrać duże ilości danych (50 megabajtów lub więcej), aplikacja powinna przesyłać strumieniowo te pliki do pobrania i nie używać domyślnego buforowania. Jeśli domyślne buforowanie jest używane, użycie pamięci klienta będzie bardzo duże, co może spowodować znaczne zmniejszenie wydajności.

Klasy w System.Net.Http przestrzeniach nazw i System.Net.Http.Headers mogą służyć do tworzenia aplikacji ze Sklepu Windows lub aplikacji klasycznych. W przypadku użycia w aplikacji ze Sklepu Windows klasy w System.Net.Http przestrzeniach nazw i System.Net.Http.Headers mają wpływ na funkcję izolacji sieci, część modelu zabezpieczeń aplikacji używanego przez Windows 8. Odpowiednie możliwości sieciowe muszą być włączone w manifeście aplikacji dla aplikacji ze Sklepu Windows dla systemu, aby umożliwić dostęp sieciowy przez aplikację ze sklepu Windows. Aby uzyskać więcej informacji, zobacz Izolacja sieci dla aplikacji ze Sklepu Windows.

Zobacz też

• System.Net.Http.Headers
• Nawiązywanie połączenia z usługą internetową
• Przykład httpclient