WebProxy Класс

Определение

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

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

Сборка:: System.dll

Сборка:: netstandard.dll

Исходный код:: WebProxy.cs

Исходный код:: WebProxy.cs

Исходный код:: WebProxy.cs

Важно!

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

Содержит параметры прокси-сервера 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

Наследование: 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. В случае успешного выполнения этих операций скрипт возвращает прокси-серверы, которые можно использовать для запроса.

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

Имя	Описание
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.

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

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы: