System.Net.Http Espacio de nombres

Proporciona una interfaz de programación para aplicaciones HTTP modernas.

Clases

ByteArrayContent

Proporciona contenido HTTP basado en una matriz de bytes.

DelegatingHandler

Un tipo para los controladores HTTP que delegan el procesamiento de los mensajes de respuesta HTTP a otro controlador, denominado controlador interno.

FormUrlEncodedContent

Contenedor para las tuplas de nombre-valor codificadas mediante el tipo MIME de application/x-www-form-urlencoded.

HttpClient

Proporciona una clase para enviar solicitudes HTTP y recibir respuestas HTTP de un recurso identificado por un URI.

HttpClientFactoryExtensions

Métodos de extensión para IHttpClientFactory.

HttpClientHandler

Controlador de mensajes predeterminado utilizado por HttpClient en .NET Framework, .NET Core 2.0 y versiones anteriores.

HttpContent

Clase base que representa un cuerpo de entidad HTTP y encabezados de contenido.

HttpDiagnosticsHttpRequestMessageExtensions

Extensiones para utilidades de telemetría.

HttpIOException

Excepción que se produce cuando se produce un error al leer la respuesta.

HttpMessageHandler

Tipo base para los controladores de mensajes HTTP.

HttpMessageHandlerFactoryExtensions

Métodos de extensión para IHttpMessageHandlerFactory.

HttpMessageInvoker

Clase especializada que permite que las aplicaciones llamen al método SendAsync(HttpRequestMessage, CancellationToken) en una cadena de controlador HTTP.

HttpMethod

Una clase del asistente para recuperar y comparar métodos HTTP estándar y para crear nuevos métodos HTTP.

HttpProtocolException

Excepción que se produce cuando se produce un error de protocolo HTTP/2 o HTTP/3.

HttpRequestException

Una clase base para las excepciones que producen las clases HttpClient y HttpMessageHandler .

HttpRequestMessage

Representa un mensaje de solicitud HTTP.

HttpRequestOptions

Representa una colección de opciones para una solicitud HTTP.

HttpResilienceHttpRequestMessageExtensions

Extensiones de resistencia para HttpRequestMessage.

HttpResponseMessage

Representa un mensaje de respuesta HTTP incluido el código de estado y los datos.

MessageProcessingHandler

Tipo base para los controladores que solo realizan un procesamiento reducido de mensajes de solicitud o respuesta.

MultipartContent

Proporciona una colección de objetos HttpContent que se serializan mediante la especificación de tipo de contenido multipart/*.

MultipartFormDataContent

Proporciona un contenedor para el contenido codificado con el tipo MIME multipart/form-data.

ReadOnlyMemoryContent

Proporciona contenido HTTP basado en un elemento ReadOnlyMemory<T>.

RtcRequestFactory

Proporciona una interfaz de programación para aplicaciones HTTP modernas.

SocketsHttpConnectionContext

Representa el contexto que se pasa al objeto ConnectCallback para una instancia de SocketsHttpHandler. .

SocketsHttpHandler

Proporciona el controlador de mensajes predeterminado utilizado por HttpClient en .NET Core 2.1 y versiones posteriores.

SocketsHttpPlaintextStreamFilterContext

Representa el contexto pasado a PlaintextStreamFilter para una instancia de SocketsHttpHandler.

StreamContent

Proporciona contenido HTTP basado en una secuencia.

StringContent

Proporciona contenido HTTP basado en una cadena.

WebRequestHandler

Proporciona características específicas de escritorio no disponibles para las aplicaciones de la Tienda Windows u otros entornos.

WinHttpHandler

Controla los mensajes basados en la interfaz WinHTTP de Windows. Esta clase está pensada para usarse en entornos de servidor.

Estructuras

HttpRequestOptionsKey<TValue>

Representa una clave de la colección de opciones para una solicitud HTTP.

Interfaces

IHttpClientFactory

Una abstracción de fábrica para un componente que puede crear instancias de HttpClient con una configuración personalizada para un nombre lógico determinado.

IHttpMessageHandlerFactory

Una abstracción de fábrica para un componente que puede crear instancias de HttpMessageHandler con una configuración personalizada para un nombre lógico determinado.

Enumeraciones

ClientCertificateOption

Especifica cómo se proporcionan los certificados de cliente.

CookieUsePolicy

Esta enumeración permite controlar las cookies HTTP al comunicarse con el servidor.

HttpCompletionOption

Indica si las operaciones de HttpClient se consideran completadas cualquiera tan pronto como una respuesta esté disponible o después de leer el mensaje de respuesta completo, incluido el contenido.

HttpKeepAlivePingPolicy

Especifica cuándo se envía el marco de ping HTTP/2 en una conexión inactiva.

HttpRequestError

Define categorías de error que representan el motivo de HttpRequestException o HttpIOException.

HttpVersionPolicy

Especifica los comportamientos para seleccionar y negociar la versión HTTP de una solicitud.

WindowsProxyUsePolicy

Esta enumeración proporciona las opciones disponibles para la configuración de proxy usada por HttpClient cuando se ejecuta en Windows.

Delegados

HeaderEncodingSelector<TContext>

Representa un método que especifica la codificación que se va a usar al interpretar los valores de encabezado.

Comentarios

El System.Net.Http espacio de nombres está diseñado para proporcionar lo siguiente:

  1. Componentes de cliente HTTP que permiten a los usuarios consumir servicios web modernos a través de HTTP.

  2. Componentes HTTP que pueden usar los clientes y servidores (encabezados HTTP y mensajes, por ejemplo). Esto proporciona un modelo de programación coherente tanto en el cliente como en el lado servidor para los servicios web modernos a través de HTTP.

El System.Net.Http espacio de nombres y el espacio de nombres relacionado System.Net.Http.Headers proporcionan el siguiente conjunto de componentes:

  1. HttpClient : la clase principal que se usa para enviar y recibir solicitudes a través de HTTP.

  2. HttpRequestMessage y HttpResponseMessage : mensajes HTTP definidos en RFC 2616 por IETF.

  3. HttpHeaders - Encabezados HTTP según se define en RFC 2616 por IETF.

  4. HttpClientHandler - Controladores HTTP responsables de generar mensajes de respuesta HTTP.

Hay varios controladores de mensajes HTTP que se pueden usar. Entre ellos se incluyen los siguientes.

  1. DelegatingHandler - Una clase que se usa para conectar un controlador a una cadena de controladores.

  2. HttpMessageHandler - Una clase simple que se deriva de que admite los requisitos más comunes para la mayoría de las aplicaciones.

  3. HttpClientHandler - Una clase que opera en la parte inferior de la cadena de controladores que controla realmente las operaciones de transporte HTTP.

  4. WebRequestHandler - Una clase especial que opera en la parte inferior de la clase de cadena de controlador que controla las operaciones de transporte HTTP con opciones específicas del System.Net.HttpWebRequest objeto.

El contenido de un mensaje HTTP corresponde al cuerpo de la entidad definido en RFC 2616.

Se pueden usar varias clases para el contenido HTTP. Entre ellos se incluyen los siguientes.

  1. ByteArrayContent - Contenido HTTP basado en una matriz de bytes.

  2. FormUrlEncodedContent - Contenido HTTP de tuplas de nombre/valor codificadas mediante el tipo MIME application/x-www-form-urlencoded.

  3. MultipartContent - Contenido HTTP que se serializa mediante la especificación de tipo de contenido multipart/*.

  4. MultipartFormDataContent - Contenido HTTP codificado mediante el tipo MIME multipart/form-data.

  5. StreamContent - Contenido HTTP basado en una secuencia.

  6. StringContent - Contenido HTTP basado en una cadena.

Si una aplicación que usa los System.Net.Http espacios de nombres y System.Net.Http.Headers pretende descargar grandes cantidades de datos (50 megabytes o más), la aplicación debe transmitir esas descargas y no usar el almacenamiento en búfer predeterminado. Si se usa el almacenamiento en búfer predeterminado, el uso de memoria del cliente obtendrá un rendimiento muy grande, lo que podría reducir considerablemente el rendimiento.

Las clases de los espacios de nombres y System.Net.Http.Headers se pueden usar para desarrollar aplicaciones de la System.Net.Http Tienda Windows o aplicaciones de escritorio. Cuando se usa en una aplicación de la Tienda Windows, las clases de los System.Net.Http espacios de nombres y System.Net.Http.Headers se ven afectadas por la característica de aislamiento de red, parte del modelo de seguridad de aplicaciones usado por el Windows 8. Las funcionalidades de red adecuadas deben estar habilitadas en el manifiesto de aplicación de una aplicación de la Tienda Windows para que el sistema permita el acceso a la red mediante una aplicación de la Tienda Windows. Para más información, vea Network Isolation for Windows Store Apps (Aislamiento de red para aplicaciones de Microsoft Store).

Consulte también