WebProxy 建構函式

定義

命名空間:

System.Net

組件:

System.Net.WebProxy.dll

初始化 WebProxy 類別的新執行個體。

多載

WebProxy()	初始化 WebProxy 類別的空執行個體。
WebProxy(String, Boolean, String[], ICredentials)	使用指定 URI、略過設定、要略過的 URI 清單和認證，初始化 WebProxy 類別的新執行個體。
WebProxy(Uri, Boolean, String[])	使用指定的 WebProxy 執行個體、略過設定和要略過的 URI 清單，初始化 Uri 類別的新執行個體。
WebProxy(String, Boolean, String[])	使用指定位址、略過設定和要略過的 URI 清單，初始化 WebProxy 類別的新執行個體。
WebProxy(Uri, Boolean)	使用 WebProxy 執行個體和略過設定，初始化 Uri 類別的新執行個體。
WebProxy(Uri, Boolean, String[], ICredentials)	使用指定的 WebProxy 執行個體、略過設定、要略過的 URI 清單和認證，初始化 Uri 類別的新執行個體。
WebProxy(String, Boolean)	使用指定 URI 和略過設定，初始化 WebProxy 類別的新執行個體。
WebProxy(SerializationInfo, StreamingContext)	已淘汰. 使用先前序列化的內容，初始化 WebProxy 類別的執行個體。
WebProxy(Uri)	從指定的 WebProxy 執行個體，初始化 Uri 類別的新執行個體。
WebProxy(String)	使用指定的 URI，初始化 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();
}

備註

沒有參數建構函式會初始化 類別的空白實例，WebProxyAddress並將屬性設定為 null。

Address當 屬性為 null時，方法IsBypassed會傳true回 ，而 GetProxy 方法會傳回目的地位址。

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

來源:

WebProxy.cs

使用指定 URI、略過設定、要略過的 URI 清單和認證，初始化 WebProxy 類別的新執行個體。

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

Proxy 伺服器的 URI。

BypassOnLocal

Boolean

若要近端網址不使用 Proxy，則為 true，否則為 false。

BypassList

String[]

規則運算式字串的陣列，其中包含要略過的伺服器 URI。

Credentials

ICredentials

ICredentials 執行個體，要送出至 Proxy 伺服器進行驗證。

例外狀況

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並將屬性設定為 Uri 實例，其中包含Address、屬性設定為 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 執行個體，其中包含 Proxy 伺服器的位址。

BypassOnLocal

Boolean

若要近端網址不使用 Proxy，則為 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實體會初始化，Address並將屬性設定為 Address、BypassProxyOnLocal屬性設定為 BypassOnLocal，並將 BypassList 屬性設定為 BypassList。

WebProxy(String, Boolean, String[])

來源:

WebProxy.cs

使用指定位址、略過設定和要略過的 URI 清單，初始化 WebProxy 類別的新執行個體。

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

Proxy 伺服器的 URI。

BypassOnLocal

Boolean

若要近端網址不使用 Proxy，則為 true，否則為 false。

BypassList

String[]

規則運算式 (Regular Expression) 字串的陣列，包含要略過的伺服器 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 執行個體，其中包含 Proxy 伺服器的位址。

BypassOnLocal

Boolean

若要近端網址不使用 Proxy，則為 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 執行個體，其中包含 Proxy 伺服器的位址。

BypassOnLocal

Boolean

若要近端網址不使用 Proxy，則為 true，否則為 false。

BypassList

String[]

規則運算式字串的陣列，其中包含要略過的伺服器 URI。

Credentials

ICredentials

ICredentials 執行個體，要送出至 Proxy 伺服器進行驗證。

範例

下列程式代碼範例示範如何呼叫這個建構函式。

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實體會初始化，Address並將屬性設定為Address、BypassProxyOnLocal屬性設定為BypassOnLocal、BypassList屬性設定為 BypassList，並將 Credentials 屬性設定為 Credentials。

WebProxy(String, Boolean)

來源:

WebProxy.cs

使用指定 URI 和略過設定，初始化 WebProxy 類別的新執行個體。

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

Proxy 伺服器的 URI。

BypassOnLocal

Boolean

若要近端網址不使用 Proxy，則為 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 執行個體，其中包含 Proxy 伺服器的位址。

範例

下列程式代碼範例示範如何呼叫這個建構函式。

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

使用指定的 URI，初始化 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

Proxy 伺服器的 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

Proxy 主機名稱。

Port

Int32

要在 Host 上使用的連接埠編號。

例外狀況

UriFormatException

結合 Host 和 Port 所形成的 URI 不是有效的 URI。

範例

下列程式代碼範例示範如何呼叫這個建構函式。

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

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

備註

WebProxy實體會初始化，Address並將屬性設定為Uri表單的實體，http:// Host ： Port。