TcpClient.Connect 方法

定义

命名空间:: System.Net.Sockets

程序集:: netstandard.dll, System.Net.Sockets.dll

程序集:: System.Net.Sockets.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

使用指定的主机名和端口号将客户端连接到远程 TCP 主机。

重载

名称	说明
Connect(IPEndPoint)	使用指定的远程网络终结点将客户端连接到远程 TCP 主机。
Connect(IPAddress, Int32)	使用指定的 IP 地址和端口号将客户端连接到远程 TCP 主机。
Connect(IPAddress[], Int32)	使用指定的 IP 地址和端口号将客户端连接到远程 TCP 主机。
Connect(String, Int32)	将客户端连接到指定主机上的指定端口。

Connect(IPEndPoint)

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: 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 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 套接字版本 2 API 错误代码文档，获取错误的详细说明。

注释

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。有关详细信息，请参阅 .NET Framework 中的 Network Tracing。

注释

如果在使用 IPv6 地址时收到包含消息 This protocol version is not supported 的 NotSupportedException，请确保通过传递 InterNetworkV6在构造函数中启用 IPv6。

另请参阅

适用于

Connect(IPAddress, Int32)

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: 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 = 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使用此来发送和接收数据。

注释

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。有关详细信息，请参阅 .NET Framework 中的 Network Tracing。

注释

如果在使用 IPv6 地址时收到包含消息 This protocol version is not supported 的 NotSupportedException，请确保通过传递 InterNetworkV6在构造函数中启用 IPv6。

另请参阅

GetStream()

适用于

Connect(IPAddress[], Int32)

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: 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 = 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使用此来发送和接收数据。

注释

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。有关详细信息，请参阅 .NET Framework 中的 Network Tracing。

注释

如果在使用 IPv6 地址时收到包含消息 This protocol version is not supported 的 NotSupportedException，请确保通过传递 InterNetworkV6在构造函数中启用 IPv6。

另请参阅

TcpListener

适用于

Connect(String, Int32)

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: 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 = 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 地址，这可能会延迟建立连接的时间。

注释

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。有关详细信息，请参阅 .NET Framework 中的 Network Tracing。

另请参阅

适用于

反馈

此页面是否有帮助？