Socket 建構函式

定義

命名空間:

Java.Net

組件:

Mono.Android.dll

多載

名稱	Description
Socket()	建立一個未連接的 socket，並使用系統預設類型的 SocketImpl。
Socket(Proxy)	建立一個未連接的 socket，指定應該使用的代理類型（如果有的話），不論其他設定如何。
Socket(SocketImpl)	建立一個未連接的 Socket，並使用使用者指定的 SocketImpl。
Socket(InetAddress, Int32)	建立串流套接字，並將其連接到指定的 IP 位址上的埠號。
Socket(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
Socket(String, Int32)	建立一個串流套接字，並將其連接到指定主機上的指定埠號。
Socket(InetAddress, Int32, Boolean)	已淘汰. 建立一個套接字，並將其連接到指定的埠號和指定的 IP 位址。
Socket(String, Int32, Boolean)	已淘汰. 建立一個串流套接字，並將其連接到指定主機上的指定埠號。
Socket(InetAddress, Int32, InetAddress, Int32)	建立一個套接字，並將其連接到指定的遠端位址、指定的遠端埠。
Socket(String, Int32, InetAddress, Int32)	建立一個 socket，並將其連接到指定的遠端主機和指定的遠端埠。

Socket()

建立一個未連接的 socket，並使用系統預設類型的 SocketImpl。

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

屬性

RegisterAttribute

備註

建立一個未連接的 socket，並使用系統預設類型的 SocketImpl。

在 1.1 版本中加入。

Java 文件 java.net.Socket.Socket()。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

另請參閱

• ISocketImplFactory
• SocketImpl

Socket(Proxy)

建立一個未連接的 socket，指定應該使用的代理類型（如果有的話），不論其他設定如何。

[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 指定應該使用何種代理的物件。

屬性

RegisterAttribute

例外狀況

IllegalArgumentException

如果參數 proxy 是 null 無效型態。

備註

建立一個未連接的 socket，指定應該使用的代理類型（如果有的話），不論其他設定如何。

若存在安全管理器，則以代理主機位址與埠號作為參數呼叫其 checkConnect 方法。 這可能導致安全例外（SecurityException）。

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

已在1.5中新增。

Java 文件 java.net.Socket.Socket(java.net.Proxy)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

另請參閱

• ISocketImplFactory
• SocketImpl

Socket(SocketImpl)

建立一個未連接的 Socket，並使用使用者指定的 SocketImpl。

[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

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

備註

建立一個未連接的 Socket，並使用使用者指定的 SocketImpl。

在 1.1 版本中加入。

Java 文件 java.net.Socket.Socket(java.net.SocketImpl)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

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 文件 java.net.Socket.Socket(java.net.InetAddress, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

Socket(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

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

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

參數

javaReference

IntPtr

nativeint

IntPtrA 包含一個 Java 原生介面（JNI）物件參考。

transfer

JniHandleOwnership

JniHandleOwnershipA 指示如何處理javaReference

備註

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

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 文件 java.net.Socket.Socket(java.lang.String, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

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，則建立串流套接字。 如果 stream 參數為 false，則會建立一個資料報套接字。

如果應用程式指定了伺服器套接程式工廠，則會呼叫該工廠的方法 createSocketImpl 來建立實際的套接程式實作。 否則就會產生一個「普通」插座。

若存在安全管理器，其checkConnect方法以 和 port 作為其參數被呼叫host.getHostAddress()。 這可能導致安全例外（SecurityException）。

若使用 UDP 套接字，則不會適用與 TCP/IP 相關套接字選項。

此會員已被棄用。 UDP 傳輸時，請使用 DatagramSocket。

Java 文件 java.net.Socket.Socket(java.net.InetAddress, int, boolean)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

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

A boolean 表示這是串流套接字還是資料報套接字。

屬性

RegisterAttribute ObsoleteAttribute

例外狀況

UnknownHostException

如果主機名稱無法解析成 IP 位址。

IOException

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

備註

建立一個串流套接字，並將其連接到指定主機上的指定埠號。

若指定的主機為 ， null 則等同於將位址指定為 java.net.InetAddress#getByName InetAddress.getByName(null)。 換句話說，它等同於指定迴路介面的位址。

若 流參數為 true，則建立串流套接字。 如果 stream 參數為 false，則會建立一個資料報套接字。

如果應用程式指定了伺服器套接程式工廠，則會呼叫該工廠的方法 createSocketImpl 來建立實際的套接程式實作。 否則就會產生一個「普通」插座。

若有安全管理器，則以主機位址 和 port 參數呼叫其checkConnect方法。 這可能導致安全例外（SecurityException）。

若使用 UDP 套接字，則不會適用與 TCP/IP 相關的套接字選項。

此會員已被棄用。 UDP 傳輸時，請使用 DatagramSocket。

Java 文件 java.net.Socket.Socket(java.lang.String, int, boolean)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

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

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

備註

建立一個套接字，並將其連接到指定的遠端位址、指定的遠端埠。 Socket 也會綁定到所提供的本地位址和埠口。

若指定的本地位址為 ， null 則等同於指定該位址為 AnyLocal 位址（參見 java.net.InetAddress#isAnyLocalAddress InetAddress.isAnyLocalAddress()）。

本地埠號 為 zero 會讓系統在操作中 bind 取得空缺埠。

若有安全管理器，則以主機位址 和 port 參數呼叫其checkConnect方法。 這可能導致安全例外（SecurityException）。

在 1.1 版本中加入。

Java 文件 java.net.Socket.Socket(java.net.InetAddress, int, java.net.InetAddress, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

Socket(String, Int32, InetAddress, Int32)

建立一個 socket，並將其連接到指定的遠端主機和指定的遠端埠。

[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

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

備註

建立一個 socket，並將其連接到指定的遠端主機和指定的遠端埠。 Socket 也會綁定到所提供的本地位址和埠口。

若指定的主機為 ， null 則等同於將位址指定為 java.net.InetAddress#getByName InetAddress.getByName(null)。 換句話說，它等同於指定迴路介面的位址。

本地埠號 為 zero 會讓系統在操作中 bind 取得空缺埠。

若有安全管理器，則以主機位址 和 port 參數呼叫其checkConnect方法。 這可能導致安全例外（SecurityException）。

在 1.1 版本中加入。

Java 文件 java.net.Socket.Socket(java.lang.String, int, java.net.InetAddress, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。