System.Net.Sockets.TcpClient

为 TCP 网络服务提供客户端连接。

命名空间：System.Net.Sockets

汇编集：System（在 system.dll 中）

语法

public class TcpClient : IDisposable

备注

TcpClient 类为了在同步阻塞模式中通过网络来连接、发送，并且接收数据流而提供了简单的方法。

如果要让 TcpClient 能够连接并且交换数据，就需要以 TCP 的 ProtocolType 创建一个 TcpListener 或者 Socket 来监听输入连接请求。你可以通过下列方式来连接到这个监听器：

• 创建一个 TcpClient 并且调用三种可用的 Connect 方法之一。
• 使用远程主机的主机名称和端口号来创建一个 TcpClient。并且这个构造器还会自动尝试一个连接。

提示：如果你需要在同步阻塞模式中发送无连接的数据包，就可以考虑使用 UdpClient 类。

继承者要注意：如果要发送和接收数据，就可以使用 GetStream 方法来获取一个 NetworkStream。然后调用 NetworkStream 的 Write 和 Read 方法来发送和接收远程主机的数据。另外，还需要使用 Close 方法来释放所有与该 TcpClient 相关的资源。

范例

下列代码建立了一个 TcpClient 连接。

static void Connect(String server, String message) 
{
  try 
  {
    // 创建一个 TcpClient。
    // 提示：如果要让该客户端工作，你需要拥有一个连接到相同地址（通过被指定的服务器和端口组合）的 TcpServer。
    Int32 port = 13000;
    TcpClient client = new TcpClient(server, port);
    
    // 把已传递的消息转化成 ASCII 并且存储成 Byte 数组。
    Byte[] data = System.Text.Encoding.ASCII.GetBytes(message);         

    // 为读取和写入操作而获取客户端数据流。
   //  Stream stream = client.GetStream();
    
    NetworkStream stream = client.GetStream();

    // 把消息发送到已连接的 TcpServer。
    stream.Write(data, 0, data.Length);

    Console.WriteLine("Sent: {0}", message);         

    // 接收 TcpServer 的回应。
    
    // 缓存回应字节。
    data = new Byte[256];

    // 存储回应 ASCII 呈现的字符串。
    String responseData = String.Empty;

    // 读取 TcpServer 回应字节中的第一批数据。
    Int32 bytes = stream.Read(data, 0, data.Length);
    responseData = System.Text.Encoding.ASCII.GetString(data, 0, bytes);
    Console.WriteLine("Received: {0}", responseData);         

    // 关闭所有。
    stream.Close();         
    client.Close();         
  } 
  catch (ArgumentNullException e) 
  {
    Console.WriteLine("ArgumentNullException: {0}", e);
  } 
  catch (SocketException e) 
  {
    Console.WriteLine("SocketException: {0}", e);
  }
    
  Console.WriteLine("\n Press Enter to continue...");
  Console.Read();
}

.NET Framework 安全性

• SocketPermission：建立一个输出连接或者接受一个输入请求。

继承层次

System.Object 
  System.Net.Sockets.TcpClient