WebProxy Класс

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

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, BypassProxyOnLocalи BypassList , заданными значениями, используемыми локальным компьютером.

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

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