Compartir vía


HttpClient.DefaultProxy Propiedad

Definición

Obtiene o establece el proxy HTTP global.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public static System.Net.IWebProxy DefaultProxy { get; set; }
static member DefaultProxy : System.Net.IWebProxy with get, set
Public Shared Property DefaultProxy As IWebProxy

Valor de propiedad

Proxy utilizado por cada solicitud HTTP.

Excepciones

El valor pasado no puede ser null.

Comentarios

Esta propiedad estática determina el proxy predeterminado que todas las HttpClient instancias usan si no se establece ningún proxy explícitamente en el HttpMessageHandler pasado a través de su constructor.

La instancia predeterminada devuelta por esta propiedad se inicializará después de un conjunto diferente de reglas en función de la plataforma:

  • Para Windows: lee la configuración de proxy de las variables de entorno o, si no se definen, de la configuración del proxy del usuario.

  • Para macOS: lee la configuración de proxy de las variables de entorno o, si no se definen, de la configuración del proxy del sistema.

  • Para Linux: lee la configuración de proxy de las variables de entorno o, en caso de que no se definan, esta propiedad inicializa una instancia no configurada que omite todas las direcciones.

Las variables de entorno que se usan para la inicialización de DefaultProxy en plataformas basadas en Windows y Unix son las siguientes:

  • HTTP_PROXY: el servidor proxy que se usa en solicitudes HTTP.
  • HTTP_PROXY: el servidor proxy que se usa en solicitudes HTTPS.
  • ALL_PROXY: el servidor proxy usado en solicitudes HTTP o HTTPS en caso de que no se definan HTTP_PROXY o HTTPS_PROXY.
  • NO_PROXY: una lista separada por comas de nombres de host que se deben excluir del proxy. No se admiten asteriscos para caracteres comodín; use un punto inicial en caso de que desee que coincida con un subdominio. Ejemplos: NO_PROXY=.example.com (con punto inicial) coincidirá con www.example.com, pero no coincidirá con example.com. NO_PROXY=example.com (sin punto inicial) no coincidirá con www.example.com. Este comportamiento se podría revisar en el futuro para que coincida mejor con otros ecosistemas.

En sistemas en los que las variables de entorno distinguen entre mayúsculas y minúsculas, los nombres de las variables pueden estar todas en minúsculas o en mayúsculas. Los nombres en minúsculas se comprueban primero.

El servidor proxy puede ser un nombre de host o una dirección IP, seguido opcionalmente de dos puntos y un número de puerto, o puede ser una dirección URL http, opcionalmente, incluir un nombre de usuario y una contraseña para la autenticación de proxy. La dirección URL debe comenzar con http, no con https, y no puede incluir ningún texto después del nombre de host, la IP o el puerto.

Se aplica a