Socket 建構函式

參考

定義

命名空間:: Java.Net

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

Socket()	使用 SocketImpl 的系統預設類型，建立未連接的套接字。
Socket(Proxy)	建立未連線的套接字，並指定不論任何其他設定為何，都應該使用的 Proxy 類型。
Socket(SocketImpl)	使用使用者指定的 SocketImpl 建立未連接的 Socket。
Socket(InetAddress, Int32)	建立資料流套接字，並將它連接到指定IP位址的指定埠號碼。
Socket(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
Socket(String, Int32)	建立數據流套接字，並將它連接到具名主機上的指定埠號碼。
Socket(InetAddress, Int32, Boolean)	已淘汰. 建立套接字，並將它連接到指定IP位址的指定埠號碼。
Socket(String, Int32, Boolean)	已淘汰. 建立數據流套接字，並將它連接到具名主機上的指定埠號碼。
Socket(InetAddress, Int32, InetAddress, Int32)	建立套接字，並將它連接到指定遠端埠上的指定遠端位址。
Socket(String, Int32, InetAddress, Int32)	建立套接字，並將它連接到指定遠端埠上的指定遠端主機。

Socket()

使用 SocketImpl 的系統預設類型，建立未連接的套接字。

[Android.Runtime.Register(".ctor", "()V", "")]
public Socket ();

屬性: RegisterAttribute

備註

使用 SocketImpl 的系統預設類型，建立未連接的套接字。

已在1.1中新增。

的 java.net.Socket.Socket()Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

另請參閱

適用於

Socket(Proxy)

建立未連線的套接字，並指定不論任何其他設定為何，都應該使用的 Proxy 類型。

[Android.Runtime.Register(".ctor", "(Ljava/net/Proxy;)V", "")]
public Socket (Java.Net.Proxy? proxy);

[<Android.Runtime.Register(".ctor", "(Ljava/net/Proxy;)V", "")>]
new Java.Net.Socket : Java.Net.Proxy -> Java.Net.Socket

參數

proxy: Proxy

物件 java.net.Proxy Proxy ，指定應該使用哪種 Proxy。

屬性: RegisterAttribute

例外狀況

IllegalArgumentException

如果自變數 proxy 為 null 或不合法的類型，則為。

備註

建立未連線的套接字，並指定不論任何其他設定為何，都應該使用的 Proxy 類型。

如果有安全性管理員，則會 checkConnect 使用 Proxy 主機位址和埠號碼作為其自變數來呼叫其方法。這可能會導致 SecurityException。

範例： <UL><LI>Socket s = new Socket(Proxy.NO_PROXY); 會建立一個忽略任何其他 Proxy 設定的純套接字。</LI><LI>Socket s = new Socket(new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("socks.mydom.com", 1080))); 會透過指定的SOCKS Proxy 伺服器建立套接字連線。</LI></UL>

已在1.5中新增。

的 java.net.Socket.Socket(java.net.Proxy)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

另請參閱

適用於

Socket(SocketImpl)

使用使用者指定的 SocketImpl 建立未連接的 Socket。

[Android.Runtime.Register(".ctor", "(Ljava/net/SocketImpl;)V", "")]
protected Socket (Java.Net.SocketImpl? impl);

[<Android.Runtime.Register(".ctor", "(Ljava/net/SocketImpl;)V", "")>]
new Java.Net.Socket : Java.Net.SocketImpl -> Java.Net.Socket

參數

impl: SocketImpl

B SocketImpl</B> 子類別想要在 Socket 上使用的實例<。>

屬性: RegisterAttribute

例外狀況

SocketException

如果建立套接字時發生錯誤，則為。

備註

使用使用者指定的 SocketImpl 建立未連接的 Socket。

已在1.1中新增。

的 java.net.Socket.Socket(java.net.SocketImpl)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(InetAddress, Int32)

建立資料流套接字，並將它連接到指定IP位址的指定埠號碼。

[Android.Runtime.Register(".ctor", "(Ljava/net/InetAddress;I)V", "")]
public Socket (Java.Net.InetAddress? address, int port);

[<Android.Runtime.Register(".ctor", "(Ljava/net/InetAddress;I)V", "")>]
new Java.Net.Socket : Java.Net.InetAddress * int -> Java.Net.Socket

參數

address: InetAddress

IP 位址。

port: Int32

埠號碼。

屬性: RegisterAttribute

例外狀況

IOException

如果建立套接字時發生錯誤，則為。

備註

建立資料流套接字，並將它連接到指定IP位址的指定埠號碼。

如果應用程式已指定套接字處理站，則會呼叫該處理站的 createSocketImpl 方法來建立實際的套接字實作。否則會建立「純文本」套接字。

如果有安全性管理員，則會使用主機位址及其port自變數呼叫其 checkConnect 方法。這可能會導致 SecurityException。

的 java.net.Socket.Socket(java.net.InetAddress, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(IntPtr, JniHandleOwnership)

建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。

protected Socket (IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);

new Java.Net.Socket : nativeint * Android.Runtime.JniHandleOwnership -> Java.Net.Socket

參數

javaReference: IntPtr
nativeint

IntPtr，包含 Java Native Interface （JNI）對象參考。

transfer: JniHandleOwnership

JniHandleOwnership，指出如何處理javaReference

備註

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(String, Int32)

建立數據流套接字，並將它連接到具名主機上的指定埠號碼。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;I)V", "")]
public Socket (string? host, int port);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;I)V", "")>]
new Java.Net.Socket : string * int -> Java.Net.Socket

參數

host: String

主機名，或 null 回送位址。

port: Int32

埠號碼。

屬性: RegisterAttribute

例外狀況

UnknownHostException

如果主機名稱無法解析為 IP 位址，則為。

IOException

如果建立套接字時發生錯誤，則為。

備註

建立數據流套接字，並將它連接到具名主機上的指定埠號碼。

如果指定的主機是 null ，則相當於將位址指定為 java.net.InetAddress#getByName InetAddress.getByName(null)。換句話說，它相當於指定回送介面的位址。

如果應用程式已指定伺服器套接字處理站，則會呼叫該處理站的 createSocketImpl 方法來建立實際的套接字實作。否則會建立「純文本」套接字。

如果有安全性管理員，則會使用主機位址及其port自變數呼叫其 checkConnect 方法。這可能會導致 SecurityException。

的 java.net.Socket.Socket(java.lang.String, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(InetAddress, Int32, Boolean)

警告

deprecated

建立套接字，並將它連接到指定IP位址的指定埠號碼。

[Android.Runtime.Register(".ctor", "(Ljava/net/InetAddress;IZ)V", "")]
[System.Obsolete("deprecated")]
public Socket (Java.Net.InetAddress? host, int port, bool stream);

[<Android.Runtime.Register(".ctor", "(Ljava/net/InetAddress;IZ)V", "")>]
[<System.Obsolete("deprecated")>]
new Java.Net.Socket : Java.Net.InetAddress * int * bool -> Java.Net.Socket

參數

host: InetAddress

IP 位址。

port: Int32

埠號碼。

stream: Boolean

如果 true為，請建立數據流套接字，否則請建立數據報套接字。

屬性: RegisterAttribute ObsoleteAttribute

例外狀況

IOException

如果建立套接字時發生錯誤，則為。

備註

建立套接字，並將它連接到指定IP位址的指定埠號碼。

如果數據流自變數為 true，這會建立數據流套接字。如果數據流自變數為 false，它會建立數據報套接字。

如果應用程式已指定伺服器套接字處理站，則會呼叫該處理站的 createSocketImpl 方法來建立實際的套接字實作。否則會建立「純文本」套接字。

如果有安全性管理員，則會 checkConnect 使用 host.getHostAddress() 和 port 作為其自變數來呼叫其方法。這可能會導致 SecurityException。

如果使用 UDP 套接字，將不會套用 TCP/IP 相關套接字選項。

已取代這個成員。請改用 DatagramSocket 進行 UDP 傳輸。

的 java.net.Socket.Socket(java.net.InetAddress, int, boolean)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(String, Int32, Boolean)

警告

deprecated

建立數據流套接字，並將它連接到具名主機上的指定埠號碼。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;IZ)V", "")]
[System.Obsolete("deprecated")]
public Socket (string? host, int port, bool stream);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;IZ)V", "")>]
[<System.Obsolete("deprecated")>]
new Java.Net.Socket : string * int * bool -> Java.Net.Socket

參數

host: String

主機名，或 null 回送位址。

port: Int32

埠號碼。

stream: Boolean

， boolean 指出這是數據流套接字或數據報套接字。

屬性: RegisterAttribute ObsoleteAttribute

例外狀況

UnknownHostException

如果主機名稱無法解析為 IP 位址，則為。

IOException

如果建立套接字時發生錯誤，則為。

備註

建立數據流套接字，並將它連接到具名主機上的指定埠號碼。

如果指定的主機是 null ，則相當於將位址指定為 java.net.InetAddress#getByName InetAddress.getByName(null)。換句話說，它相當於指定回送介面的位址。

如果數據流自變數為 true，這會建立數據流套接字。如果數據流自變數為 false，它會建立數據報套接字。

如果應用程式已指定伺服器套接字處理站，則會呼叫該處理站的 createSocketImpl 方法來建立實際的套接字實作。否則會建立「純文本」套接字。

如果有安全性管理員，則會使用主機位址及其port自變數呼叫其 checkConnect 方法。這可能會導致 SecurityException。

如果使用 UDP 套接字，將不會套用 TCP/IP 相關套接字選項。

已取代這個成員。請改用 DatagramSocket 進行 UDP 傳輸。

的 java.net.Socket.Socket(java.lang.String, int, boolean)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(InetAddress, Int32, InetAddress, Int32)

建立套接字，並將它連接到指定遠端埠上的指定遠端位址。

[Android.Runtime.Register(".ctor", "(Ljava/net/InetAddress;ILjava/net/InetAddress;I)V", "")]
public Socket (Java.Net.InetAddress? address, int port, Java.Net.InetAddress? localAddr, int localPort);

[<Android.Runtime.Register(".ctor", "(Ljava/net/InetAddress;ILjava/net/InetAddress;I)V", "")>]
new Java.Net.Socket : Java.Net.InetAddress * int * Java.Net.InetAddress * int -> Java.Net.Socket

參數

address: InetAddress

遠端位址

port: Int32

遠端埠

localAddr: InetAddress

套接字系結至的本機位址，或 null 位址的 anyLocal 本機位址。

localPort: Int32

套接字系結至本機埠，或 zero 針對系統選取的免費埠。

屬性: RegisterAttribute

例外狀況

IOException

如果建立套接字時發生錯誤，則為。

備註

建立套接字，並將它連接到指定遠端埠上的指定遠端位址。套接字也會系結至提供的本機位址和埠。

如果指定的本機位址是 null ，則相當於將位址指定為 AnyLocal 位址（請參閱 java.net.InetAddress#isAnyLocalAddress InetAddress.isAnyLocalAddress()）。

的 zero 本機埠號碼會讓系統在作業中 bind 挑選免費埠。

如果有安全性管理員，則會使用主機位址及其port自變數呼叫其 checkConnect 方法。這可能會導致 SecurityException。

已在1.1中新增。

的 java.net.Socket.Socket(java.net.InetAddress, int, java.net.InetAddress, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

Socket(String, Int32, InetAddress, Int32)

建立套接字，並將它連接到指定遠端埠上的指定遠端主機。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;ILjava/net/InetAddress;I)V", "")]
public Socket (string? host, int port, Java.Net.InetAddress? localAddr, int localPort);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;ILjava/net/InetAddress;I)V", "")>]
new Java.Net.Socket : string * int * Java.Net.InetAddress * int -> Java.Net.Socket

參數

host: String

遠端主機的名稱，或 null 回送位址的名稱。

port: Int32

遠端埠

localAddr: InetAddress

套接字系結至的本機位址，或 null 位址的 anyLocal 本機位址。

localPort: Int32

套接字系結至的本機埠，或 zero 針對系統選取的免費埠。

屬性: RegisterAttribute

例外狀況

UnknownHostException

如果主機名稱無法解析為 IP 位址，則為。

IOException

如果建立套接字時發生錯誤，則為。

備註

建立套接字，並將它連接到指定遠端埠上的指定遠端主機。套接字也會系結至提供的本機位址和埠。

如果指定的主機是 null ，則相當於將位址指定為 java.net.InetAddress#getByName InetAddress.getByName(null)。換句話說，它相當於指定回送介面的位址。

的 zero 本機埠號碼會讓系統在作業中 bind 挑選免費埠。

如果有安全性管理員，則會使用主機位址及其port自變數呼叫其 checkConnect 方法。這可能會導致 SecurityException。

已在1.1中新增。

的 java.net.Socket.Socket(java.lang.String, int, java.net.InetAddress, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

共用方式為

Socket 建構函式

定義

多載

Socket()

備註

另請參閱

適用於

Socket(Proxy)

參數

例外狀況

備註

另請參閱

適用於

Socket(SocketImpl)

參數

例外狀況

備註

適用於

Socket(InetAddress, Int32)

參數

例外狀況

備註

適用於

Socket(IntPtr, JniHandleOwnership)

參數

備註

適用於

Socket(String, Int32)

參數

例外狀況

備註

適用於

Socket(InetAddress, Int32, Boolean)

參數

例外狀況

備註

適用於

Socket(String, Int32, Boolean)

參數

例外狀況

備註

適用於

Socket(InetAddress, Int32, InetAddress, Int32)

參數

例外狀況

備註

適用於

Socket(String, Int32, InetAddress, Int32)

參數

例外狀況

備註

適用於

其他資源