HttpClient.DefaultProxy Свойство

Определение

Пространство имен:
System.Net.Http
Сборки:
netstandard.dll, System.Net.Http.dll
Сборка:
System.Net.Http.dll
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

Возвращает или задает глобальный прокси-сервер HTTP.

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

Значение свойства

IWebProxy

Прокси- сервер, используемый каждым HTTP-запросом.

Исключения

ArgumentNullException

Переданное значение не может быть null.

Комментарии

Это статическое свойство определяет прокси-сервер по умолчанию, используемый всеми HttpClient экземплярами, если прокси-сервер не задан явным образом в переданном конструкторе HttpMessageHandler .

Экземпляр по умолчанию, возвращаемый этим свойством, будет инициализировать следующий набор правил в зависимости от платформы:

  • For Windows: Считывает конфигурацию прокси-сервера из переменных среды или, если они не определены, из параметров прокси-сервера пользователя.

  • Для macOS: Считывает конфигурацию прокси-сервера из переменных среды или, если они не определены, из параметров прокси-сервера системы.

  • Для Linux: Считывает конфигурацию прокси-сервера из переменных среды или, если они не определены, это свойство инициализирует не настроенный экземпляр, который проходит все адреса.

Переменные среды, используемые для инициализации DefaultProxy на платформах под управлением Windows и Unix:

  • HTTP_PROXY: прокси-сервер, используемый в HTTP-запросах.
  • HTTPS_PROXY: прокси-сервер, используемый в HTTPS-запросах.
  • ALL_PROXY: прокси-сервер, используемый в HTTP-запросах и(или) HTTPS в случае, если HTTP_PROXY и/или HTTPS_PROXY не определены.
  • NO_PROXY: разделенный запятыми список имен узлов, которые должны быть исключены из использования прокси-сервера. Звездочки не поддерживаются для подстановочных знаков; используйте ведущую точку в случае, если вы хотите сопоставить поддомен. Примеры: NO_PROXY=.example.com (с начальной точкой) будет соответствовать www.example.com, но не будет соответствовать example.com. NO_PROXY=example.com (без начальной точки) не будет соответствовать www.example.com. Это поведение может быть пересмотрено в будущем, чтобы соответствовать другим экосистемам лучше.

В системах, где переменные среды чувствительны к регистру, имена переменных могут быть все строчные или все прописные. Сначала проверяются имена в нижнем регистре.

Прокси-сервер может быть именем узла или IP-адресом, за которым при необходимости следует двоеточие и номер порта, или это может быть http, , socks4ahttpssocks4или socks5 URL-адрес. URL-адрес не может содержать текст после имени узла, IP-адреса или порта. Если схема не указана, http предполагается. URL-адрес может включать имя пользователя и пароль для проверки подлинности прокси-сервера, но пароль игнорируется при использовании socks4 или socks4a в качестве протоколов не поддерживает проверку подлинности паролей.

  • http: http://[username:password@]hostname[:port]
  • https: https://[username:password@]hostname[:port]
  • socks4: socks4://[username@]hostname[:port]
  • socks4a: socks4a://[username@]hostname[:port]
  • socks5: socks5://[username:password@]hostname[:port]

Применяется к