语言

TcpClient 构造函数

定义

初始化 TcpClient 类的新实例。

重载

名称 说明
TcpClient()

初始化 TcpClient 类的新实例。

TcpClient(IPEndPoint)

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

TcpClient(AddressFamily)

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

TcpClient(String, Int32)

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

TcpClient()

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

初始化 TcpClient 类的新实例。

public:
 TcpClient();
public TcpClient();
Public Sub New ()

示例

下面的代码示例演示如何使用无参数构造函数创建新的 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 中的 Network Tracing。

另请参阅

适用于

TcpClient(IPEndPoint)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

IPEndPoint绑定到 TCP Socket的项。

例外

参数 localEP 为 null.

示例

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

//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 中的 Network Tracing。

另请参阅

适用于

TcpClient(AddressFamily)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

AddressFamily IP 协议。

例外

参数 family 不等于 AddressFamily.InterNetwork

-或-

参数 family 不等于 AddressFamily.InterNetworkV6

示例

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

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

注解

注释

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

适用于

TcpClient(String, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

例外

参数 hostname 为 null.

参数 port 不介于 MinPort 和 MaxPort.

访问套接字时出错。

示例

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

//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 中的 Network Tracing。

另请参阅

适用于