HttpClient.DefaultProxy Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Shared Property DefaultProxy As IWebProxyValor 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á conwww.example.com, pero no coincidirá conexample.com.NO_PROXY=example.com(sin punto inicial) no coincidirá conwww.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.
