WebProxy Класс

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebProxy.dll

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

WebProxy.cs

Содержит параметры прокси-сервера HTTP для HttpClient класса.

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Наследование

Object

WebProxy

Реализации

IWebProxy ISerializable

Примеры

Следующий пример кода настраивает HttpClient экземпляр с экземпляром WebProxy . Экземпляр HttpClient использует прокси-сервер для подключения к внешним ресурсам Интернета. (Пример, демонстрирующий использование функции WPAD, см. в документации по классу IWebProxyScript .)

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

Комментарии

Класс WebProxy содержит параметры прокси-сервера, используемые для определения того, HttpClient используется ли веб-прокси для отправки запросов. Глобальные параметры веб-прокси можно указать в файлах конфигурации компьютера и приложения, а приложения могут использовать экземпляры WebProxy класса для настройки использования веб-прокси. Класс WebProxy является базовой IWebProxy реализацией интерфейса.

Чтобы получить экземпляры класса веб-прокси, можно использовать любой из следующих методов:

• Конструктор WebProxy .
• Метод GetDefaultProxy.
• Метод Select.

Эти методы предоставляют WebProxy экземпляр, который можно настроить. Разница между ними заключается в том, как экземпляр инициализирован до возвращения в приложение. Конструктор WebProxy возвращает экземпляр WebProxy класса с заданным nullсвойствомAddress. Если запрос использует WebProxy экземпляр в этом состоянии, прокси-сервер не используется для отправки запроса.

Метод GetDefaultProxy возвращает экземпляр WebProxy класса с Addressсвойствами, BypassProxyOnLocalBypassList заданными для значений, используемых локальным компьютером.

Метод Select возвращает экземпляр WebProxy класса со свойствами, заданными в соответствии с сочетанием параметров интернета и файла конфигурации.

Класс WebProxy поддерживает автоматическое обнаружение и выполнение скриптов конфигурации прокси-сервера. Эта функция также называется автоматическое обнаружение веб-прокси (WPAD). При использовании автоматической конфигурации прокси-сервера скрипт конфигурации, обычно именованный Wpad.dat, должен находиться, загружаться, компилироваться и запускаться. В случае успешного выполнения этих операций скрипт возвращает прокси-серверы, которые можно использовать для запроса.

Конструкторы

Имя	Описание
WebProxy()	Инициализирует пустой экземпляр WebProxy класса.
WebProxy(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует экземпляр класса с помощью ранее сериализованного содержимого WebProxy .
WebProxy(String, Boolean, String[], ICredentials)	Инициализирует новый экземпляр WebProxy класса с указанным URI, параметром обхода, списком URI для обхода и учетными данными.
WebProxy(String, Boolean, String[])	Инициализирует новый экземпляр WebProxy класса с указанным URI, параметром обхода и списком URI для обхода.
WebProxy(String, Boolean)	Инициализирует новый экземпляр WebProxy класса с указанным URI и параметром обхода.
WebProxy(String, Int32)	Инициализирует новый экземпляр WebProxy класса с указанным номером узла и порта.
WebProxy(String)	Инициализирует новый экземпляр WebProxy класса с указанным универсальным кодом ресурса (URI).
WebProxy(Uri, Boolean, String[], ICredentials)	Инициализирует новый экземпляр класса с указанным Uri экземпляромWebProxy, параметр обхода, список URI для обхода и учетных данных.
WebProxy(Uri, Boolean, String[])	Инициализирует новый экземпляр класса с указанным Uri экземпляромWebProxy, параметром обхода и списком URI для обхода.
WebProxy(Uri, Boolean)	Инициализирует новый экземпляр класса с параметром экземпляра WebProxy и обхода Uri .
WebProxy(Uri)	Инициализирует новый экземпляр класса из указанного WebProxyUri экземпляра.

Свойства

Имя	Описание
Address	Возвращает или задает адрес прокси-сервера.
BypassArrayList	Возвращает список адресов, которые не используют прокси-сервер.
BypassList	Возвращает или задает массив адресов, которые не используют прокси-сервер.
BypassProxyOnLocal	Возвращает или задает значение, указывающее, следует ли обойти прокси-сервер для локальных адресов.
Credentials	Возвращает или задает учетные данные для отправки на прокси-сервер для проверки подлинности.
UseDefaultCredentials	Возвращает или задает Boolean значение, которое определяет, отправляются ли DefaultCredentials запросы.

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetDefaultProxy()	Устаревшие.. Считывает параметры нединамического прокси-сервера в Интернете.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Заполняет SerializationInfo данные, необходимые для сериализации целевого объекта.
GetProxy(Uri)	Возвращает прокси-код ресурса (URI) для запроса.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsBypassed(Uri)	Указывает, следует ли использовать прокси-сервер для указанного узла.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Создает данные сериализации и контекст, используемые системой для сериализации WebProxy объекта.