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的项。

例外

参数 localEPnull.

示例

下面的代码示例演示如何使用本地终结点创建类的 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

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

例外

参数 hostnamenull.

参数 port 不介于 MinPortMaxPort.

访问套接字时出错。

示例

下面的代码示例演示如何使用主机名和端口号创建类的 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

另请参阅

适用于