TcpClient.Connect 方法

  • 參考

定義

命名空間:
System.Net.Sockets
組件:
System.Net.Sockets.dll
組件:
System.dll
組件:
netstandard.dll

使用指定的主機名稱和連接埠號碼將用戶端連接至遠端 TCP 主機。

多載

Connect(IPEndPoint)

使用指定的遠端網路端點將用戶端連接至遠端 TCP 主機。
Connect(IPAddress, Int32)

使用指定的 IP 位址和連接埠號碼將用戶端連接至遠端 TCP 主機。
Connect(IPAddress[], Int32)

使用指定的 IP 位址和連接埠號碼，將用戶端連接至遠端 TCP 主機。
Connect(String, Int32)

將用戶端連接到所指定主機上的指定連接埠。

Connect(IPEndPoint)

來源:
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。

例外狀況

ArgumentNullException

remoteEp 參數為 null。

SocketException

存取通訊端時發生錯誤。

ObjectDisposedException

TcpClient 已關閉。

範例

下列程式代碼範例會使用 IPEndPoint 與遠端主機連線。

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( 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 傳送和接收數據。

注意

如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參閱 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

注意

如果您在使用 IPv6 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException，則請傳遞 InterNetworkV6，確定您已在建構函式中啟用 IPv6。

另請參閱

適用於

Connect(IPAddress, Int32)

來源:
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

您要連接的連接埠號碼。

例外狀況

ArgumentNullException

address 參數為 null。

ArgumentOutOfRangeException

port 不在 MinPort 和 MaxPort 之間。

SocketException

存取通訊端時發生錯誤。

ObjectDisposedException

TcpClient 已關閉。

範例

下列程式代碼範例會使用IP位址和埠號碼來與遠端主機連線。

//Uses the IP address and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
tcpClient->Connect( ipAddress, 11003 );

//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 傳送和接收數據。

注意

如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參閱 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

注意

如果您在使用 IPv6 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException，則請傳遞 InterNetworkV6，確定您已在建構函式中啟用 IPv6。

另請參閱

適用於

Connect(IPAddress[], Int32)

來源:
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

您要連接的連接埠號碼。

例外狀況

ArgumentNullException

ipAddresses 參數為 null。

ArgumentOutOfRangeException

連接埠號碼無效。

SocketException

嘗試存取通訊端時發生錯誤。

ObjectDisposedException

Socket 已關閉。

SecurityException

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

NotSupportedException

這個方法對使用 InterNetwork 旗標或 InterNetworkV6 旗標的通訊端有效。

範例

下列程式代碼範例會使用IP位址和埠號碼來與遠端主機連線。

static void DoConnect( String^ host, int port )
{
   // Connect to the specified host.
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}

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 傳送和接收數據。

注意

如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參閱 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

注意

如果您在使用 IPv6 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException，則請傳遞 InterNetworkV6，確定您已在建構函式中啟用 IPv6。

另請參閱

適用於

Connect(String, Int32)

來源:
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

您要連接之遠端主機的連接埠號碼。

例外狀況

ArgumentNullException

hostname 參數為 null。

ArgumentOutOfRangeException

port 參數不是介於 MinPort 和 MaxPort。

SocketException

存取通訊端時發生錯誤。

ObjectDisposedException

TcpClient 已關閉。

範例

下列程式代碼範例會使用主機名和埠號碼來與遠端主機連線。

//Uses a host name and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );

//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 位址，這可能會延遲建立連線的時間。

注意

如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參閱 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

另請參閱

適用於