TcpClient.Connect 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
利用指定的主機名稱和埠號將用戶端連接到遠端 TCP 主機。
多載
| 名稱 | Description |
|---|---|
| Connect(IPEndPoint) |
透過指定的遠端網路端點,將用戶端連接到遠端 TCP 主機。 |
| Connect(IPAddress, Int32) |
利用指定的 IP 位址和埠號將用戶端連接到遠端 TCP 主機。 |
| Connect(IPAddress[], Int32) |
利用指定的 IP 位址和埠號將用戶端連接到遠端 TCP 主機。 |
| Connect(String, Int32) |
將用戶端連接到指定主機上的指定埠口。 |
Connect(IPEndPoint)
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
透過指定的遠端網路端點,將用戶端連接到遠端 TCP 主機。
public:
void Connect(System::Net::IPEndPoint ^ remoteEP);
public void Connect(System.Net.IPEndPoint remoteEP);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (remoteEP As IPEndPoint)
參數
- remoteEP
- IPEndPoint
你打算連結的那個 IPEndPoint 。
例外狀況
參數 remoteEP 為 null。
存取該套接字時發生錯誤。
那是 TcpClient 關門的。
範例
以下程式碼範例使用 與 IPEndPoint 遠端主機連接。
//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);
tcpClient.Connect (ipEndPoint);
'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
tcpClient.Connect(ipEndPoint)
備註
呼叫此方法以建立與指定 IPEndPoint的同步遠端主機連線。 在呼叫 Connect之前,你必須用 IP 位址和埠號建立該 IPEndPoint 類別的實例。 用這個 IPEndPoint 作為參數 remoteEP 。 這個 Connect 方法會阻塞,直到連接成功或失敗為止。 連接遠端主機後,使用 GetStream 該方法取得底層 NetworkStream的 。 用這個 NetworkStream 來傳送和接收資料。
Note
如果您收到 SocketException,請使用 SocketException.ErrorCode 以取得特定的錯誤代碼。 取得這些程式碼後,你可以參考 Windows Sockets 版本 2 的 API 錯誤程式碼 文件,了解錯誤的詳細說明。
Note
當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。
Note
如果你在使用 IPv6 位址時收到 NotSupportedException This protocol version is not supported 訊息,請確保你在建構程序中啟用 IPv6,並傳遞 InterNetworkV6。
另請參閱
適用於
Connect(IPAddress, Int32)
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
利用指定的 IP 位址和埠號將用戶端連接到遠端 TCP 主機。
public:
void Connect(System::Net::IPAddress ^ address, int port);
public void Connect(System.Net.IPAddress address, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (address As IPAddress, port As Integer)
參數
- port
- Int32
你打算連接的埠號。
例外狀況
參數 address 為 null。
存取該套接字時發生錯誤。
範例
以下程式碼範例使用IP位址與埠號來連接遠端主機。
//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
tcpClient.Connect (ipAddress, 11003);
'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)
備註
呼叫此方法即可建立與指定 IPAddress 及埠號的同步遠端主機連線。 這個 Connect 方法會阻塞,直到連接成功或失敗為止。 連接遠端主機後,使用 GetStream 該方法取得底層 NetworkStream的 。 用這個 NetworkStream 來傳送和接收資料。
Note
如果您收到 SocketException,請使用 SocketException.ErrorCode 以取得特定的錯誤代碼。 取得這些程式碼後,你可以參考 Windows Sockets 版本 2 的 API 錯誤程式碼 文件,了解錯誤的詳細說明。
Note
當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。
Note
如果你在使用 IPv6 位址時收到 NotSupportedException This protocol version is not supported 訊息,請確保你在建構程序中啟用 IPv6,並傳遞 InterNetworkV6。
另請參閱
適用於
Connect(IPAddress[], Int32)
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
利用指定的 IP 位址和埠號將用戶端連接到遠端 TCP 主機。
public:
void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);
public void Connect(System.Net.IPAddress[] ipAddresses, int port);
member this.Connect : System.Net.IPAddress[] * int -> unit
Public Sub Connect (ipAddresses As IPAddress(), port As Integer)
參數
- port
- Int32
你打算連接的埠號。
例外狀況
參數 ipAddresses 為 null。
嘗試存取該套接字時發生錯誤。
該店 Socket 已經關閉。
呼叫堆疊中較高的呼叫者沒有該請求操作的權限。
此方法適用於使用 該 InterNetwork 標誌或 標誌的 InterNetworkV6 套接字。
範例
以下程式碼範例使用IP位址與埠號來連接遠端主機。
static void DoConnect(string host, int port)
{
// Connect to the specified host.
TcpClient t = new TcpClient(AddressFamily.InterNetwork);
IPAddress[] IPAddresses = Dns.GetHostAddresses(host);
Console.WriteLine("Establishing connection to {0}", host);
t.Connect(IPAddresses, port);
Console.WriteLine("Connection established");
}
備註
此方法通常在呼叫 BeginGetHostAddresses 該方法後立即使用,該方法可為單一主機回傳多個 IP 位址。 呼叫 Connect 建立與由元素陣列 IPAddress 及埠號指定的主機建立同步遠端主機連線的方法。 這個 Connect 方法會阻塞,直到連接成功或失敗為止。 連接遠端主機後,使用 GetStream 該方法取得底層 NetworkStream的 。 用這個 NetworkStream 來傳送和接收資料。
Note
如果您收到 SocketException,請使用 SocketException.ErrorCode 以取得特定的錯誤代碼。 取得這些程式碼後,你可以參考 Windows Sockets 版本 2 的 API 錯誤程式碼 文件,了解錯誤的詳細說明。
Note
當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。
Note
如果你在使用 IPv6 位址時收到 NotSupportedException This protocol version is not supported 訊息,請確保你在建構程序中啟用 IPv6,並傳遞 InterNetworkV6。
另請參閱
適用於
Connect(String, Int32)
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
- 來源:
- TCPClient.cs
將用戶端連接到指定主機上的指定埠口。
public:
void Connect(System::String ^ hostname, int port);
public void Connect(string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)
參數
- hostname
- String
你打算連接的遠端主機的 DNS 名稱。
- port
- Int32
你打算連接的遠端主機的埠號。
例外狀況
參數 hostname 為 null。
存取該套接字時發生錯誤。
範例
以下程式碼範例使用主機名稱與埠號來連接遠端主機。
//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);
'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()
tcpClient.Connect("www.contoso.com", 11002)
備註
呼叫此方法可建立與指定主機名稱及埠號的同步遠端主機連線。 這個 Connect 方法會阻塞,直到連接成功或失敗為止。 連接遠端主機後,使用 GetStream 該方法取得底層 NetworkStream的 。 用這個 NetworkStream 來傳送和接收資料。
若啟用 IPv6 並 Connect(String, Int32) 呼叫該方法連接同時解析至 IPv6 與 IPv4 位址的主機,則先嘗試連接 IPv6 位址,再嘗試連接 IPv4 位址。 若主機未監聽 IPv6 位址,這可能會延遲建立連線的時間。
Note
如果您收到 SocketException,請使用 SocketException.ErrorCode 以取得特定的錯誤代碼。 取得這些程式碼後,你可以參考 Windows Sockets 版本 2 的 API 錯誤程式碼 文件,了解錯誤的詳細說明。
Note
當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。