WebProxy Класс

Определение

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

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
Наследование
WebProxy
Атрибуты
Реализации

Примеры

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

WebProxy^ proxyObject = gcnew WebProxy( "http://proxyserver:80/",true );
WebRequest^ req = WebRequest::Create( "http://www.contoso.com" );
req->Proxy = proxyObject;
WebProxy proxyObject = new WebProxy("http://proxyserver:80/",true);
WebRequest req = WebRequest.Create("http://www.contoso.com");
req.Proxy = proxyObject;
Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
Dim req As WebRequest = WebRequest.Create("http://www.contoso.com")
req.Proxy = proxyObject

Комментарии

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

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

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

Метод GetDefaultProxy возвращает экземпляр WebProxy класса со Addressсвойством и BypassProxyOnLocalBypassList значениями, используемыми 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()
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.

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