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

Определение

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

System.Net

Сборка:

System.Net.WebProxy.dll

Инициализирует новый экземпляр класса WebProxy.

Перегрузки

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

WebProxy()

Исходный код:

WebProxy.cs

Инициализирует пустой экземпляр класса WebProxy.

public:
 WebProxy();

public WebProxy ();

Public Sub New ()

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxy()
{
   return gcnew WebProxy;
}

public static WebProxy CreateProxy()
{
    return new WebProxy();
}

Комментарии

Конструктор без параметров инициализирует пустой WebProxy экземпляр класса со свойством Address , равным null.

Address Если свойство имеет значение null, IsBypassed метод возвращает true , а GetProxy метод — адрес назначения.

WebProxy(String, Boolean, String[], ICredentials)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с указанным URI, настройками для пропускаемых адресов, списком пропускаемых URI и учетными данными.

public:
 WebProxy(System::String ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList, System::Net::ICredentials ^ Credentials);

public WebProxy (string? Address, bool BypassOnLocal, string[]? BypassList, System.Net.ICredentials? Credentials);

new System.Net.WebProxy : string * bool * string[] * System.Net.ICredentials -> System.Net.WebProxy

Public Sub New (Address As String, BypassOnLocal As Boolean, BypassList As String(), Credentials As ICredentials)

Параметры

Address

String

URI прокси-сервера.

BypassOnLocal

Boolean

true при обходе прокси-сервера для локальных адресов, в противном случае false.

BypassList

String[]

Массив строк регулярных выражений, содержащих URI пропускаемых серверов.

Credentials

ICredentials

Экземпляр ICredentials для передачи прокси-серверу с целью проверки подлинности.

Исключения

UriFormatException

Address не является допустимым URI.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithCredentials( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList,
      CredentialCache::DefaultCredentials );
}

public static WebProxy CreateProxyWithCredentials(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy("http://contoso",
        bypassLocal,
        bypassList,
        CredentialCache.DefaultCredentials);
}

Комментарии

Экземпляр WebProxy инициализируется с Address помощью свойства , который содержит AddressUri экземпляр , свойство имеет значение BypassOnLocal, BypassListBypassProxyOnLocal свойство имеет значение BypassList, а свойство имеет значение , а Credentials свойство имеет значение Credentials.

См. также раздел

• BypassProxyOnLocal
• BypassList

WebProxy(Uri, Boolean, String[])

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с указанным экземпляром Uri, настройками для пропускаемых адресов и списком пропускаемых URI.

public:
 WebProxy(Uri ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList);

public WebProxy (Uri? Address, bool BypassOnLocal, string[]? BypassList);

new System.Net.WebProxy : Uri * bool * string[] -> System.Net.WebProxy

Public Sub New (Address As Uri, BypassOnLocal As Boolean, BypassList As String())

Параметры

Address

Uri

Экземпляр Uri, содержащий адрес прокси-сервера.

BypassOnLocal

Boolean

true при обходе прокси-сервера для локальных адресов, в противном случае false.

BypassList

String[]

Массив строк регулярных выражений, содержащих URI пропускаемых серверов.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithBypassList( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( gcnew Uri( "http://contoso" ),
      bypassLocal,
      bypassList );
}

public static WebProxy CreateProxyWithBypassList(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy(new Uri("http://contoso"),
        bypassLocal,
        bypassList);
}

Комментарии

Экземпляр WebProxy инициализируется свойством AddressAddress , свойству BypassProxyOnLocal присваивается значение BypassOnLocal, а свойству BypassList — значение BypassList.

WebProxy(String, Boolean, String[])

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с указанным URI, настройками для пропускаемых адресов и списком пропускаемых URI.

public:
 WebProxy(System::String ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList);

public WebProxy (string? Address, bool BypassOnLocal, string[]? BypassList);

new System.Net.WebProxy : string * bool * string[] -> System.Net.WebProxy

Public Sub New (Address As String, BypassOnLocal As Boolean, BypassList As String())

Параметры

Address

String

URI прокси-сервера.

BypassOnLocal

Boolean

true при обходе прокси-сервера для локальных адресов, в противном случае false.

BypassList

String[]

Массив строк регулярных выражений, содержащих URI пропускаемых серверов.

Исключения

UriFormatException

Address не является допустимым URI.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithHostAndBypassList( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList );
}

public static WebProxy CreateProxyWithHostAndBypassList(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy("http://contoso",
        bypassLocal,
        bypassList);
}

Комментарии

Экземпляр WebProxy инициализируется с Address помощью свойства , которому присваивается Uri экземпляр , который содержит Address, BypassProxyOnLocal свойство имеет значение BypassOnLocal, а BypassList свойство имеет значение BypassList.

См. также раздел

• BypassProxyOnLocal
• BypassList

WebProxy(Uri, Boolean)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с экземпляром Uri и настройками для пропускаемых адресов.

public:
 WebProxy(Uri ^ Address, bool BypassOnLocal);

public WebProxy (Uri? Address, bool BypassOnLocal);

new System.Net.WebProxy : Uri * bool -> System.Net.WebProxy

Public Sub New (Address As Uri, BypassOnLocal As Boolean)

Параметры

Address

Uri

Экземпляр Uri, содержащий адрес прокси-сервера.

BypassOnLocal

Boolean

true при обходе прокси-сервера для локальных адресов, в противном случае false.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithExampleAddress( bool bypassLocal )
{
   return gcnew WebProxy( gcnew Uri( "http://contoso" ), bypassLocal );
}

public static WebProxy CreateProxyWithExampleAddress(bool bypassLocal)
{
    return new WebProxy(new Uri("http://contoso"), bypassLocal);
}

Комментарии

Экземпляр WebProxy инициализируется со свойством Address , для свойства задано значение Address , а BypassProxyOnLocal для свойства — значение BypassOnLocal.

WebProxy(Uri, Boolean, String[], ICredentials)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с указанным экземпляром Uri, настройками для пропускаемых адресов, списком пропускаемых URI и учетными данными.

public:
 WebProxy(Uri ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList, System::Net::ICredentials ^ Credentials);

public WebProxy (Uri? Address, bool BypassOnLocal, string[]? BypassList, System.Net.ICredentials? Credentials);

new System.Net.WebProxy : Uri * bool * string[] * System.Net.ICredentials -> System.Net.WebProxy

Public Sub New (Address As Uri, BypassOnLocal As Boolean, BypassList As String(), Credentials As ICredentials)

Параметры

Address

Uri

Экземпляр Uri, содержащий адрес прокси-сервера.

BypassOnLocal

Boolean

true при обходе прокси-сервера для локальных адресов, в противном случае false.

BypassList

String[]

Массив строк регулярных выражений, содержащих URI пропускаемых серверов.

Credentials

ICredentials

Экземпляр ICredentials для передачи прокси-серверу с целью проверки подлинности.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithCredentials2( bool bypassLocal )
{
   
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( gcnew Uri( "http://contoso" ),
      bypassLocal,
      bypassList,
      CredentialCache::DefaultCredentials );
}

public static WebProxy CreateProxyWithCredentials2(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy(new Uri("http://contoso"),
        bypassLocal,
        bypassList,
        CredentialCache.DefaultCredentials);
}

Комментарии

Экземпляр WebProxy инициализируется свойством AddressAddress, свойству BypassProxyOnLocal присвоено значение BypassOnLocal, свойству присвоено значение , свойству BypassListBypassListприсвоено значение , а свойству Credentials — значение Credentials.

WebProxy(String, Boolean)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с указанным URI и параметром обхода.

public:
 WebProxy(System::String ^ Address, bool BypassOnLocal);

public WebProxy (string? Address, bool BypassOnLocal);

new System.Net.WebProxy : string * bool -> System.Net.WebProxy

Public Sub New (Address As String, BypassOnLocal As Boolean)

Параметры

Address

String

URI прокси-сервера.

BypassOnLocal

Boolean

true при обходе прокси-сервера для локальных адресов, в противном случае false.

Исключения

UriFormatException

Address не является допустимым URI.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithHostAddress( bool bypassLocal )
{
   WebProxy^ proxy = gcnew WebProxy( "http://contoso",bypassLocal );
   Console::WriteLine( "Bypass proxy for local URIs?: {0}", 
      proxy->BypassProxyOnLocal );
   return proxy;
}

public static WebProxy CreateProxyWithHostAddress(bool bypassLocal)
{
    WebProxy proxy =  new WebProxy("http://contoso", bypassLocal);
    Console.WriteLine("Bypass proxy for local URIs?: {0}",
       proxy.BypassProxyOnLocal);
    return proxy;
}

Комментарии

Экземпляр WebProxy инициализируется с Address помощью свойства , которому присваивается Uri экземпляр , который содержит Address , а свойству BypassProxyOnLocal присваивается значение BypassOnLocal.

См. также раздел

• BypassProxyOnLocal

WebProxy(SerializationInfo, StreamingContext)

Исходный код:

WebProxy.cs

Внимание!

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Инициализирует экземпляр класса WebProxy и использованием ранее сериализованного содержимого.

protected:
 WebProxy(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected WebProxy (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Net.WebProxy : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Net.WebProxy

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Параметры

serializationInfo

SerializationInfo

Данные сериализации.

streamingContext

StreamingContext

Контекст для данных сериализации.

Атрибуты

ObsoleteAttribute

Комментарии

Этот метод вызывается системой для десериализации экземпляра WebProxy ; приложения не вызывают его.

WebProxy(Uri)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy из указанного экземпляра Uri.

public:
 WebProxy(Uri ^ Address);

public WebProxy (Uri? Address);

new System.Net.WebProxy : Uri -> System.Net.WebProxy

Public Sub New (Address As Uri)

Параметры

Address

Uri

Экземпляр Uri, содержащий адрес прокси-сервера.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithExampleAddress()
{
   return gcnew WebProxy( gcnew Uri( "http://contoso" ) );
}

public static WebProxy CreateProxyWithExampleAddress()
{
    return new WebProxy(new Uri("http://contoso"));
}

Комментарии

Экземпляр WebProxy инициализируется Address с помощью свойства , заданного параметром Address .

WebProxy(String)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с заданным универсальным кодом ресурса.

public:
 WebProxy(System::String ^ Address);

public WebProxy (string? Address);

new System.Net.WebProxy : string -> System.Net.WebProxy

Public Sub New (Address As String)

Параметры

Address

String

URI прокси-сервера.

Исключения

UriFormatException

Address не является допустимым URI.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithHost()
{
   return gcnew WebProxy( "http://contoso" );
}

public static WebProxy CreateProxyWithHost()
{
    return new WebProxy("http://contoso");
}

Комментарии

Экземпляр WebProxy инициализируется с Address помощью свойства , задается экземпляр , Uri содержащий Address.

WebProxy(String, Int32)

Исходный код:

WebProxy.cs

Инициализирует новый экземпляр класса WebProxy с указанным узлом и номером порта.

public:
 WebProxy(System::String ^ Host, int Port);

public WebProxy (string Host, int Port);

new System.Net.WebProxy : string * int -> System.Net.WebProxy

Public Sub New (Host As String, Port As Integer)

Параметры

Host

String

Имя узла прокси-сервера.

Port

Int32

Номер порта используемого Host.

Исключения

UriFormatException

URI, образованный сочетанием Host и Port, является недопустимым.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

WebProxy^ CreateProxyWithHostAndPort()
{
   return gcnew WebProxy( "contoso",80 );
}

public static WebProxy CreateProxyWithHostAndPort()
{
    return new WebProxy("contoso", 80);
}

Комментарии

Экземпляр WebProxy инициализируется со свойством Address , равным Uri экземпляру формы http:// Host : Port.