WebProxy Класс

Ссылка

Определение

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

Сборка:: System.Net.WebProxy.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

public ref class WebProxy : System::Runtime::Serialization::ISerializable

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

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

[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

[<System.Serializable>]
type WebProxy = class
    interface IWebProxy
    interface ISerializable

[<System.Serializable>]
type WebProxy = class
    interface ISerializable
    interface IWebProxy

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Наследование: Object
WebProxy

Атрибуты: SerializableAttribute

Реализации: IWebProxy ISerializable

Примеры

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

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

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

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 класса со свойством Address , равным null. Если запрос использует WebProxy экземпляр в этом состоянии, для отправки запроса не используется прокси-сервер.

Метод GetDefaultProxy возвращает экземпляр WebProxy класса со свойствами Address, и BypassList со значениями, BypassProxyOnLocalиспользуемыми Internet Explorer 5.5 и более поздних версий.

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

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

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

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

Свойства

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

Методы

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

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Создает данные и контекст сериализации, которые будут использоваться в системе для сериализации объекта WebProxy.

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