Поделиться через


HttpClient.DefaultProxy Свойство

Определение

Возвращает или устанавливает глобальный прокси-сервер 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

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

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

Исключения

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

Комментарии

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

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

  • Для 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-адресом, за которыми при необходимости следуют двоеточие и номер порта, или URL-адрес HTTP, при необходимости включающий имя пользователя и пароль для проверки подлинности прокси-сервера. URL-адрес должен начинаться с http, а не httpsдолжен содержать текст после имени узла, IP-адреса или порта.

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