語言

TcpClient.Connect 方法

定義

利用指定的主機名稱和埠號將用戶端連接到遠端 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)

參數

address
IPAddress

你 IPAddress 打算連接的主機。

port
Int32

你打算連接的埠號。

例外狀況

參數 address 為 null。

不 port 介於 MinPort 與 MaxPort之間。

存取該套接字時發生錯誤。

範例

以下程式碼範例使用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)

參數

ipAddresses
IPAddress[]

你 IPAddress 打算連接的主機陣列。

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。

參數 port 不介於 MinPort 與 MaxPort之間。

存取該套接字時發生錯誤。

範例

以下程式碼範例使用主機名稱與埠號來連接遠端主機。

//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框架中的網絡追蹤。

另請參閱

適用於