WinForm实现同一台电脑两个程序间的TCP通信

 更新时间:2026年05月06日 09:15:32   作者:小小小陆  
这篇文章主要为大家详细介绍了两套完整可直接运行的WinForm程序代码,实现同一台电脑上的TCP通信,代码详细带注释,界面简易,复制即可部署使用,适合新手入门学习

本文提供两套完整可直接运行的WinForm程序代码,实现同一台电脑上的TCP通信:程序A(服务端)负责启动TCP监听、等待连接并接收消息,程序B(客户端)负责连接程序A并发送消息。代码详细带注释,界面简易,复制即可部署使用,适合新手入门学习。

一、前期准备(VS2022环境)

首先在Visual Studio 2022中创建两个「Windows 窗体应用 (.NET Framework)」项目,命名如下,避免混淆:

  • 项目1:TCPServer(程序A,TCP监听端/服务端)
  • 项目2:TCPClient(程序B,TCP连接端/客户端)

提示:两个项目的.NET Framework版本保持一致(建议选择4.7.2及以上),避免兼容性问题。

二、程序A(TCP监听服务端)完整实现

2.1 界面设计(简易版)

TCPServer项目的Form1窗体上,拖拽3个控件,布局如下(无需复杂设计,能满足基础功能即可):

  • TextBox控件:命名为txtMsg,设置 Multiline = true(允许多行显示)、Dock = Top(停靠在顶部),用于显示监听状态、接收的消息。
  • Button控件1:命名为btnStart,文本设置为「启动监听」,用于启动TCP监听服务。
  • Button控件2:命名为btnStop,文本设置为「停止监听」,用于停止监听并释放资源。

界面效果参考:顶部是消息显示框,下方两个按钮并排,简洁直观。

2.2 完整代码(直接复制覆盖)

双击Form1窗体,打开代码编辑器,删除默认代码,复制以下完整代码(带详细注释,关键步骤标注清晰):

using System;
using System.Net;
using System.Net.Sockets;
using System.Text;
using System.Threading;
using System.Windows.Forms;

namespace TCPServer
{
    public partial class Form1 : Form
    {
        // TCP监听套接字(核心对象,负责监听客户端连接)
        private TcpListener tcpListener;
        // 客户端连接套接字(与客户端建立连接后,用于接收消息)
        private TcpClient clientSocket;
        // 监听线程(将监听操作放入后台线程,防止界面卡死)
        private Thread listenThread;
        // 服务端IP和端口(同一台电脑固定用本地回环地址127.0.0.1,端口可自定义,需与客户端一致)
        private readonly string ip = "127.0.0.1";
        private readonly int port = 8888;

        public Form1()
        {
            InitializeComponent();
            // 绑定窗体关闭事件,关闭时释放所有资源,避免内存泄漏
            this.FormClosing += Form1_FormClosing;
        }

        // 「启动监听」按钮点击事件
        private void btnStart_Click(object sender, EventArgs e)
        {
            // 启动后台监听线程,避免阻塞主线程(界面卡死)
            listenThread = new Thread(StartListen);
            listenThread.IsBackground = true; // 设为后台线程,关闭程序时自动退出
            listenThread.Start();
            // 向消息框添加状态提示
            AppendMsg("服务端已启动监听:" + ip + ":" + port);
        }

        // 核心方法:启动TCP监听,等待客户端连接
        private void StartListen()
        {
            try
            {
                // 创建TCP监听对象,绑定IP和端口
                tcpListener = new TcpListener(IPAddress.Parse(ip), port);
                // 启动监听服务
                tcpListener.Start();
                AppendMsg("等待客户端连接...");

                // 死循环监听(阻塞方法,必须放在线程中),持续等待客户端连接
                while (true)
                {
                    // 接受客户端的连接请求,建立连接
                    clientSocket = tcpListener.AcceptTcpClient();
                    AppendMsg("客户端已连接!");

                    // 开启新线程接收该客户端的消息(多线程支持,可扩展多客户端连接)
                    Thread receiveThread = new Thread(ReceiveMsg);
                    receiveThread.IsBackground = true;
                    receiveThread.Start(clientSocket);
                }
            }
            catch (Exception ex)
            {
                // 捕获异常,避免程序崩溃,提示异常信息
                AppendMsg("监听异常:" + ex.Message);
            }
        }

        // 接收客户端发送的消息
        private void ReceiveMsg(object obj)
        {
            // 将传入的参数转为TcpClient对象(与当前连接的客户端绑定)
            TcpClient client = (TcpClient)obj;
            // 获取网络数据流,用于读取客户端发送的数据
            NetworkStream stream = client.GetStream();

            try
            {
                byte[] buffer = new byte[1024]; // 数据缓冲区,用于存储接收的字节数据(1024字节足够日常使用)
                int len; // 实际读取到的字节长度

                // 循环读取客户端消息(stream.Read()是阻塞方法,客户端断开连接时会抛出异常)
                while ((len = stream.Read(buffer, 0, buffer.Length)) > 0)
                {
                    // 将字节数据转为UTF-8编码的字符串(与客户端编码一致,避免乱码)
                    string msg = Encoding.UTF8.GetString(buffer, 0, len);
                    // 显示客户端发送的消息
                    AppendMsg("客户端说:" + msg);
                }
            }
            catch
            {
                // 客户端断开连接时,提示状态
                AppendMsg("客户端断开连接");
            }
        }

        // 「停止监听」按钮点击事件
        private void btnStop_Click(object sender, EventArgs e)
        {
            // 停止监听,释放监听资源
            tcpListener?.Stop();
            // 关闭客户端连接,释放连接资源
            clientSocket?.Close();
            AppendMsg("服务端已停止监听");
        }

        // 窗体关闭事件:释放所有资源
        private void Form1_FormClosing(object sender, FormClosingEventArgs e)
        {
            // 安全释放资源,避免程序异常
            tcpListener?.Stop();
            clientSocket?.Close();
        }

        // 跨线程安全更新界面消息(子线程不能直接操作窗体控件,需通过Invoke实现)
        private void AppendMsg(string msg)
        {
            // 判断是否需要跨线程调用
            if (txtMsg.InvokeRequired)
            {
                // 跨线程调用,更新消息框内容
                txtMsg.Invoke(new Action(() =>
                {
                    txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
                }));
            }
            else
            {
                // 主线程直接更新
                txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
            }
        }
    }
}

三、程序B(TCP客户端)完整实现

3.1 界面设计(简易版)

TCPClient项目的Form1窗体上,拖拽4个控件,布局如下:

  • TextBox控件1:命名为txtMsg,设置 Multiline = trueDock = Top,用于显示连接状态、发送/接收的消息。
  • TextBox控件2:命名为txtSend,用于输入要发送给服务端的消息(单行即可)。
  • Button控件1:命名为btnConnect,文本设置为「连接服务端」,用于连接程序A(服务端)。
  • Button控件2:命名为btnSend,文本设置为「发送消息」,用于向服务端发送消息。

界面效果参考:顶部消息显示框,中间是输入框,下方两个按钮并排。

3.2 完整代码(直接复制覆盖)

双击Form1窗体,打开代码编辑器,删除默认代码,复制以下完整代码(与服务端对应,编码一致,注释详细):

using System;
using System.Net.Sockets;
using System.Text;
using System.Threading;
using System.Windows.Forms;

namespace TCPClient
{
    public partial class Form1 : Form
    {
        // TCP客户端套接字(核心对象,用于连接服务端并发送消息)
        private TcpClient clientSocket;
        // 服务端IP和端口(必须与服务端完全一致,否则无法连接)
        private readonly string serverIp = "127.0.0.1";
        private readonly int serverPort = 8888;

        public Form1()
        {
            InitializeComponent();
            // 绑定窗体关闭事件,释放资源
            this.FormClosing += Form1_FormClosing;
        }

        // 「连接服务端」按钮点击事件
        private void btnConnect_Click(object sender, EventArgs e)
        {
            try
            {
                // 创建TCP客户端对象
                clientSocket = new TcpClient();
                // 连接服务端(IP和端口必须与服务端一致)
                clientSocket.Connect(serverIp, serverPort);
                AppendMsg("成功连接到服务端!");

                // 开启线程接收服务端消息(本案例服务端暂只接收消息,可扩展双向通信)
                Thread receiveThread = new Thread(ReceiveMsg);
                receiveThread.IsBackground = true;
                receiveThread.Start();
            }
            catch (Exception ex)
            {
                // 连接失败时提示异常信息(常见原因:服务端未启动、端口不一致)
                AppendMsg("连接失败:" + ex.Message);
            }
        }

        // 接收服务端发送的消息(可扩展双向通信,目前预留)
        private void ReceiveMsg()
        {
            try
            {
                // 获取与服务端通信的网络数据流
                NetworkStream stream = clientSocket.GetStream();
                byte[] buffer = new byte[1024]; // 数据缓冲区
                int len; // 实际读取的字节长度

                // 循环读取服务端消息
                while ((len = stream.Read(buffer, 0, buffer.Length)) > 0)
                {
                    string msg = Encoding.UTF8.GetString(buffer, 0, len);
                    AppendMsg("服务端说:" + msg);
                }
            }
            catch
            {
                // 与服务端断开连接时提示
                AppendMsg("与服务端断开连接");
            }
        }

        // 「发送消息」按钮点击事件
        private void btnSend_Click(object sender, EventArgs e)
        {
            // 先判断是否已连接服务端,未连接则提示
            if (clientSocket == null || !clientSocket.Connected)
            {
                MessageBox.Show("请先连接服务端!");
                return;
            }

            try
            {
                // 获取输入框中的消息,去除前后空格
                string sendMsg = txtSend.Text.Trim();
                if (string.IsNullOrEmpty(sendMsg)) return; // 空消息不发送

                // 将字符串转为UTF-8编码的字节流(与服务端编码一致)
                byte[] buffer = Encoding.UTF8.GetBytes(sendMsg);
                // 获取网络数据流,发送消息到服务端
                NetworkStream stream = clientSocket.GetStream();
                stream.Write(buffer, 0, buffer.Length);

                // 显示自己发送的消息
                AppendMsg("你说:" + sendMsg);
                txtSend.Clear(); // 发送后清空输入框
            }
            catch (Exception ex)
            {
                // 发送失败时提示异常信息
                AppendMsg("发送失败:" + ex.Message);
            }
        }

        // 窗体关闭事件:释放客户端资源
        private void Form1_FormClosing(object sender, FormClosingEventArgs e)
        {
            clientSocket?.Close();
        }

        // 跨线程安全更新界面消息(与服务端逻辑一致)
        private void AppendMsg(string msg)
        {
            if (txtMsg.InvokeRequired)
            {
                txtMsg.Invoke(new Action(() =>
                {
                    txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
                }));
            }
            else
            {
                txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
            }
        }
    }
}

四、运行步骤(超级简单,新手也能搞定)

先启动「程序A(TCPServer)」:点击窗体上的【启动监听】按钮,消息框会显示「服务端已启动监听:127.0.0.1:8888」和「等待客户端连接…」,说明监听成功。

再启动「程序B(TCPClient)」:点击窗体上的【连接服务端】按钮,消息框显示「成功连接到服务端!」,此时程序A的消息框会显示「客户端已连接!」,说明双方连接成功。

发送消息:在程序B的「txtSend」输入框中输入文字(比如“Hello,服务端!”),点击【发送消息】,程序B会显示自己发送的消息,程序A会实时收到并显示「客户端说:Hello,服务端!」。

停止测试:程序A点击【停止监听】,会停止接收消息;关闭两个程序时,会自动释放所有资源,避免异常。

五、关键知识点说明(新手必看)

5.1 同一台电脑通信的核心

使用本地回环地址 127.0.0.1(无论电脑是否联网,都能实现本地通信),服务端和客户端的端口必须完全一致(本文用8888,可自定义,建议选择1024以上端口,避免与系统端口冲突)。

5.2 为什么要用线程?

TCP的AcceptTcpClient()(监听连接)和 stream.Read()(读取消息)都是「阻塞方法」,如果直接放在主线程(界面线程)中,会导致界面卡死,无法操作按钮、输入内容,因此必须放在后台线程中执行。

5.3 跨线程更新界面

C# WinForm中,子线程(后台线程)不能直接操作窗体控件(比如更新TextBox的内容),否则会报错,因此需要通过 Invoke方法实现跨线程安全更新,本文中 AppendMsg方法就是专门做这件事的。

5.4 资源释放

在窗体关闭、停止监听时,必须调用 Stop()Close() 方法释放 TcpListenerTcpClientNetworkStream 的资源,避免内存泄漏和程序异常。

六、扩展功能(可选,按需扩展)

本文实现的是「客户端发送、服务端接收」的单向通信,可轻松扩展以下功能:

  • 双向通信:在服务端添加一个输入框和发送按钮,复制客户端的发送逻辑,即可实现服务端向客户端发送消息。
  • 多客户端连接:修改服务端的监听逻辑,用集合存储多个客户端的 TcpClient 对象,实现群聊效果。
  • 发送文件:通过 NetworkStream 传输文件字节流,添加文件选择、进度显示功能。
  • 心跳检测:定期发送心跳包,检测客户端/服务端是否在线,避免连接异常断开。
  • 消息加密:对发送的字节流进行加密(比如AES加密),提高通信安全性。

七、常见问题排查

问题1:客户端连接失败,提示「无法连接到目标主机」?

解决:先启动服务端,再启动客户端;检查服务端和客户端的IP、端口是否一致。

问题2:发送消息后,服务端接收不到?

解决:检查编码是否一致(本文均用UTF-8);检查客户端是否已成功连接服务端。

问题3:界面卡死?

解决:确认监听、接收消息的操作是否放在了后台线程中,是否设置了 IsBackground = true

问题4:关闭程序后,再次启动提示「地址已在使用」?

解决:端口被占用,可更换一个端口(比如9999),确保服务端和客户端端口一致;或等待1-2分钟,系统自动释放端口。

总结

本文提供的两套代码,完全独立、可直接运行,实现了同一台电脑上两个WinForm程序的TCP基础通信,包含了线程安全、异常处理、资源释放等核心细节,适合新手学习TCP通信的基本原理,也可直接用于简单的项目场景。

如果需要扩展功能(比如双向通信、发送文件),可根据文中提示自行修改

到此这篇关于WinForm实现同一台电脑两个程序间的TCP通信的文章就介绍到这了,更多相关WinForm程序TCP通信内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • C# InitializeComponent()方法案例详解

    C# InitializeComponent()方法案例详解

    这篇文章主要介绍了C# InitializeComponent()方法案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-08-08
  • C#使用集合实现二叉查找树

    C#使用集合实现二叉查找树

    这篇文章介绍了C#使用集合实现二叉查找树的方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-08-08
  • vscode设置Fira_Code字体及改变编辑器字体、背景颜色的代码详解

    vscode设置Fira_Code字体及改变编辑器字体、背景颜色的代码详解

    这篇文章主要介绍了vscode设置Fira_Code字体及改变编辑器字体、背景颜色,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • C#中正则表达式的3种匹配模式

    C#中正则表达式的3种匹配模式

    本文主要介绍在C#中正则匹配的三种模式:单行模式(Singleline)、多行模式(Multiline)与忽略大小写(IgnoreCase),希望能帮到大家。
    2016-05-05
  • WPF中MVVM模式的理解与实现

    WPF中MVVM模式的理解与实现

    MVVM是一种设计模式,特别适用于WPF(Windows Presentation Foundation)等XAML-based的应用程序开发,MVVM模式主要包含三个部分:Model(模型)、View(视图)和ViewModel(视图模型),本文给大家介绍了WPF中MVVM模式的理解与实现,需要的朋友可以参考下
    2024-05-05
  • 基于字符集、字符编码与HTTP编码解码之万象详解

    基于字符集、字符编码与HTTP编码解码之万象详解

    本篇文章小编为大家介绍,基于字符集、字符编码与HTTP编码解码之万象详解。需要的朋友参考下
    2013-04-04
  • C#实现获取Excel中图片所在坐标位置

    C#实现获取Excel中图片所在坐标位置

    本文以C#和vb.net代码示例展示如何来获取Excel工作表中图片的坐标位置,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2022-04-04
  • C#正则表达式匹配与替换字符串功能示例

    C#正则表达式匹配与替换字符串功能示例

    这篇文章主要介绍了C#正则表达式匹配与替换字符串功能,结合具体实例形式分析了C#字符串正则替换相关类、方法的使用技巧与相关注意事项,需要的朋友可以参考下
    2017-06-06
  • C#判断网站是否能访问或者断链的方法

    C#判断网站是否能访问或者断链的方法

    这篇文章主要介绍了C#判断网站是否能访问或者断链的方法,实例分析了C#判断网站是否能访问的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-07-07
  • 使用C#实现数据结构堆的代码

    使用C#实现数据结构堆的代码

    这篇文章主要介绍了使用C#实现数据结构堆,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-02-02

最新评论