TcpClient 构造函数

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

初始化 TcpClient 类的新实例。

重载

TcpClient()	初始化 TcpClient 类的新实例。
TcpClient(IPEndPoint)	初始化 TcpClient 类的新实例，并将其绑定到指定的本地终结点。
TcpClient(AddressFamily)	使用指定的族初始化 TcpClient 类的新实例。
TcpClient(String, Int32)	初始化 TcpClient 类的新实例并连接到指定主机上的指定端口。

TcpClient()

Source:

TCPClient.cs

初始化 TcpClient 类的新实例。

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

示例

下面的代码示例演示如何使用无参数构造函数创建新的 TcpClient。

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();

'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

注解

此构造函数创建新的 TcpClient ，并允许基础服务提供程序分配最合适的本地 IP 地址和端口号。 在发送和接收数据之前， Connect 必须先调用 方法。

注意

在 .NET Framework，此构造函数仅适用于 IPv4 地址类型。

备注

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

另请参阅

• Connect(String, Int32)

TcpClient(IPEndPoint)

Source:

TCPClient.cs

初始化 TcpClient 类的新实例，并将其绑定到指定的本地终结点。

public:
 TcpClient(System::Net::IPEndPoint ^ localEP);

public TcpClient (System.Net.IPEndPoint localEP);

new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient

Public Sub New (localEP As IPEndPoint)

参数

localEP

IPEndPoint

要将 TCP Socket 绑定到的 IPEndPoint。

例外

ArgumentNullException

localEP 参数为 null。

示例

下面的代码示例演示如何使用本地终结点创建 类的 TcpClient 实例。

//Creates a TCPClient using a local end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);

'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

注解

此构造函数创建一个新的 TcpClient 并将其绑定到 IPEndPoint 参数指定的 localEP 。 在调用此构造函数之前，必须使用要从中发送和接收数据的 IP 地址和端口号创建 IPEndPoint 。 在连接和通信之前，无需指定本地 IP 地址和端口号。 如果使用任何其他构造函数创建 TcpClient ，则基础服务提供程序将分配最合适的本地 IP 地址和端口号。

在发送和接收数据之前， Connect 必须调用 方法。

备注

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

另请参阅

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Source:

TCPClient.cs

使用指定的族初始化 TcpClient 类的新实例。

public:
 TcpClient(System::Net::Sockets::AddressFamily family);

public TcpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient

Public Sub New (family As AddressFamily)

参数

family

AddressFamily

IP 协议的 AddressFamily。

例外

ArgumentException

family 参数不等于 AddressFamily.InterNetwork

或

family 参数不等于 AddressFamily.InterNetworkV6

示例

下面的代码示例演示如何创建 类的 TcpClient 实例。

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

注解

备注

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

TcpClient(String, Int32)

Source:

TCPClient.cs

初始化 TcpClient 类的新实例并连接到指定主机上的指定端口。

public:
 TcpClient(System::String ^ hostname, int port);

public TcpClient (string hostname, int port);

new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient

Public Sub New (hostname As String, port As Integer)

参数

hostname

String

要连接到的远程主机的 DNS 名。

port

Int32

要连接到的远程主机的端口号。

例外

ArgumentNullException

hostname 参数为 null。

ArgumentOutOfRangeException

port 参数不介于 MinPort 与 MaxPort 之间。

SocketException

访问套接字时出错。

示例

下面的代码示例演示如何使用主机名和端口号创建 类的 TcpClient 实例。

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

注解

此构造函数创建新的 ， TcpClient 并尝试与提供的主机名和端口号进行同步连接。 基础服务提供商将分配最合适的本地 IP 地址和端口号。 TcpClient 将阻止，直到它连接或失败。 此构造函数允许你在一个方便的步骤中初始化、解析 DNS 主机名和连接。

如果启用了 IPv6 并 TcpClient(String, Int32) 调用 方法以连接到同时解析为 IPv6 和 IPv4 地址的主机，则会先尝试连接到 IPv6 地址，然后再尝试该 IPv4 地址。 如果主机未侦听 IPv6 地址，这可能会延迟建立连接的时间。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

备注

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

另请参阅

• TcpClient
• Connect(String, Int32)