WebProxy Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит параметры прокси-сервера 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
Public Class WebProxy
Implements ISerializable, IWebProxy
Public Class WebProxy
Implements ISerializable
- Наследование
-
WebProxy
- Атрибуты
- Реализации
Примеры
В следующем примере кода настраивается 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. В случае успешного выполнения этих операций скрипт возвращает прокси-серверы, которые можно использовать для запроса.
Конструкторы
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 вместе с запросами. |
Методы
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. |