HttpClient.DefaultProxy Свойство

Определение

Пространство имен:

System.Net.Http

Сборка:

System.Net.Http.dll

Исходный код:

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 через его конструкторе.

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

• Для 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-адреса или порта.