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.
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.
HttpIOException	Excepción que se produce cuando se produce un error al leer la respuesta.
HttpMessageHandler	Tipo base para los controladores de mensajes HTTP.
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.
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>.
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.

Estructuras

HttpRequestOptionsKey<TValue>

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

Enumeraciones

ClientCertificateOption	Especifica cómo se proporcionan los certificados de cliente.
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.

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

• System.Net.Http.Headers
• Conectar con un servicio web
• Ejemplo de HttpClient