WinForm實(shí)現(xiàn)同一臺(tái)電腦兩個(gè)程序間的TCP通信
本文提供兩套完整可直接運(yùn)行的WinForm程序代碼,實(shí)現(xiàn)同一臺(tái)電腦上的TCP通信:程序A(服務(wù)端)負(fù)責(zé)啟動(dòng)TCP監(jiān)聽(tīng)、等待連接并接收消息,程序B(客戶端)負(fù)責(zé)連接程序A并發(fā)送消息。代碼詳細(xì)帶注釋,界面簡(jiǎn)易,復(fù)制即可部署使用,適合新手入門學(xué)習(xí)。
一、前期準(zhǔn)備(VS2022環(huán)境)
首先在Visual Studio 2022中創(chuàng)建兩個(gè)「Windows 窗體應(yīng)用 (.NET Framework)」項(xiàng)目,命名如下,避免混淆:
- 項(xiàng)目1:
TCPServer(程序A,TCP監(jiān)聽(tīng)端/服務(wù)端) - 項(xiàng)目2:
TCPClient(程序B,TCP連接端/客戶端)
提示:兩個(gè)項(xiàng)目的.NET Framework版本保持一致(建議選擇4.7.2及以上),避免兼容性問(wèn)題。
二、程序A(TCP監(jiān)聽(tīng)服務(wù)端)完整實(shí)現(xiàn)
2.1 界面設(shè)計(jì)(簡(jiǎn)易版)
在TCPServer項(xiàng)目的Form1窗體上,拖拽3個(gè)控件,布局如下(無(wú)需復(fù)雜設(shè)計(jì),能滿足基礎(chǔ)功能即可):
- TextBox控件:命名為
txtMsg,設(shè)置Multiline = true(允許多行顯示)、Dock = Top(??吭陧敳浚糜陲@示監(jiān)聽(tīng)狀態(tài)、接收的消息。 - Button控件1:命名為
btnStart,文本設(shè)置為「啟動(dòng)監(jiān)聽(tīng)」,用于啟動(dòng)TCP監(jiān)聽(tīng)服務(wù)。 - Button控件2:命名為
btnStop,文本設(shè)置為「停止監(jiān)聽(tīng)」,用于停止監(jiān)聽(tīng)并釋放資源。
界面效果參考:頂部是消息顯示框,下方兩個(gè)按鈕并排,簡(jiǎn)潔直觀。
2.2 完整代碼(直接復(fù)制覆蓋)
雙擊Form1窗體,打開(kāi)代碼編輯器,刪除默認(rèn)代碼,復(fù)制以下完整代碼(帶詳細(xì)注釋,關(guān)鍵步驟標(biāo)注清晰):
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監(jiān)聽(tīng)套接字(核心對(duì)象,負(fù)責(zé)監(jiān)聽(tīng)客戶端連接)
private TcpListener tcpListener;
// 客戶端連接套接字(與客戶端建立連接后,用于接收消息)
private TcpClient clientSocket;
// 監(jiān)聽(tīng)線程(將監(jiān)聽(tīng)操作放入后臺(tái)線程,防止界面卡死)
private Thread listenThread;
// 服務(wù)端IP和端口(同一臺(tái)電腦固定用本地回環(huán)地址127.0.0.1,端口可自定義,需與客戶端一致)
private readonly string ip = "127.0.0.1";
private readonly int port = 8888;
public Form1()
{
InitializeComponent();
// 綁定窗體關(guān)閉事件,關(guān)閉時(shí)釋放所有資源,避免內(nèi)存泄漏
this.FormClosing += Form1_FormClosing;
}
// 「啟動(dòng)監(jiān)聽(tīng)」按鈕點(diǎn)擊事件
private void btnStart_Click(object sender, EventArgs e)
{
// 啟動(dòng)后臺(tái)監(jiān)聽(tīng)線程,避免阻塞主線程(界面卡死)
listenThread = new Thread(StartListen);
listenThread.IsBackground = true; // 設(shè)為后臺(tái)線程,關(guān)閉程序時(shí)自動(dòng)退出
listenThread.Start();
// 向消息框添加狀態(tài)提示
AppendMsg("服務(wù)端已啟動(dòng)監(jiān)聽(tīng):" + ip + ":" + port);
}
// 核心方法:?jiǎn)?dòng)TCP監(jiān)聽(tīng),等待客戶端連接
private void StartListen()
{
try
{
// 創(chuàng)建TCP監(jiān)聽(tīng)對(duì)象,綁定IP和端口
tcpListener = new TcpListener(IPAddress.Parse(ip), port);
// 啟動(dòng)監(jiān)聽(tīng)服務(wù)
tcpListener.Start();
AppendMsg("等待客戶端連接...");
// 死循環(huán)監(jiān)聽(tīng)(阻塞方法,必須放在線程中),持續(xù)等待客戶端連接
while (true)
{
// 接受客戶端的連接請(qǐng)求,建立連接
clientSocket = tcpListener.AcceptTcpClient();
AppendMsg("客戶端已連接!");
// 開(kāi)啟新線程接收該客戶端的消息(多線程支持,可擴(kuò)展多客戶端連接)
Thread receiveThread = new Thread(ReceiveMsg);
receiveThread.IsBackground = true;
receiveThread.Start(clientSocket);
}
}
catch (Exception ex)
{
// 捕獲異常,避免程序崩潰,提示異常信息
AppendMsg("監(jiān)聽(tīng)異常:" + ex.Message);
}
}
// 接收客戶端發(fā)送的消息
private void ReceiveMsg(object obj)
{
// 將傳入的參數(shù)轉(zhuǎn)為TcpClient對(duì)象(與當(dāng)前連接的客戶端綁定)
TcpClient client = (TcpClient)obj;
// 獲取網(wǎng)絡(luò)數(shù)據(jù)流,用于讀取客戶端發(fā)送的數(shù)據(jù)
NetworkStream stream = client.GetStream();
try
{
byte[] buffer = new byte[1024]; // 數(shù)據(jù)緩沖區(qū),用于存儲(chǔ)接收的字節(jié)數(shù)據(jù)(1024字節(jié)足夠日常使用)
int len; // 實(shí)際讀取到的字節(jié)長(zhǎng)度
// 循環(huán)讀取客戶端消息(stream.Read()是阻塞方法,客戶端斷開(kāi)連接時(shí)會(huì)拋出異常)
while ((len = stream.Read(buffer, 0, buffer.Length)) > 0)
{
// 將字節(jié)數(shù)據(jù)轉(zhuǎn)為UTF-8編碼的字符串(與客戶端編碼一致,避免亂碼)
string msg = Encoding.UTF8.GetString(buffer, 0, len);
// 顯示客戶端發(fā)送的消息
AppendMsg("客戶端說(shuō):" + msg);
}
}
catch
{
// 客戶端斷開(kāi)連接時(shí),提示狀態(tài)
AppendMsg("客戶端斷開(kāi)連接");
}
}
// 「停止監(jiān)聽(tīng)」按鈕點(diǎn)擊事件
private void btnStop_Click(object sender, EventArgs e)
{
// 停止監(jiān)聽(tīng),釋放監(jiān)聽(tīng)資源
tcpListener?.Stop();
// 關(guān)閉客戶端連接,釋放連接資源
clientSocket?.Close();
AppendMsg("服務(wù)端已停止監(jiān)聽(tīng)");
}
// 窗體關(guān)閉事件:釋放所有資源
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
// 安全釋放資源,避免程序異常
tcpListener?.Stop();
clientSocket?.Close();
}
// 跨線程安全更新界面消息(子線程不能直接操作窗體控件,需通過(guò)Invoke實(shí)現(xiàn))
private void AppendMsg(string msg)
{
// 判斷是否需要跨線程調(diào)用
if (txtMsg.InvokeRequired)
{
// 跨線程調(diào)用,更新消息框內(nèi)容
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客戶端)完整實(shí)現(xiàn)
3.1 界面設(shè)計(jì)(簡(jiǎn)易版)
在TCPClient項(xiàng)目的Form1窗體上,拖拽4個(gè)控件,布局如下:
- TextBox控件1:命名為
txtMsg,設(shè)置Multiline = true、Dock = Top,用于顯示連接狀態(tài)、發(fā)送/接收的消息。 - TextBox控件2:命名為
txtSend,用于輸入要發(fā)送給服務(wù)端的消息(單行即可)。 - Button控件1:命名為
btnConnect,文本設(shè)置為「連接服務(wù)端」,用于連接程序A(服務(wù)端)。 - Button控件2:命名為
btnSend,文本設(shè)置為「發(fā)送消息」,用于向服務(wù)端發(fā)送消息。
界面效果參考:頂部消息顯示框,中間是輸入框,下方兩個(gè)按鈕并排。
3.2 完整代碼(直接復(fù)制覆蓋)
雙擊Form1窗體,打開(kāi)代碼編輯器,刪除默認(rèn)代碼,復(fù)制以下完整代碼(與服務(wù)端對(duì)應(yīng),編碼一致,注釋詳細(xì)):
using System;
using System.Net.Sockets;
using System.Text;
using System.Threading;
using System.Windows.Forms;
namespace TCPClient
{
public partial class Form1 : Form
{
// TCP客戶端套接字(核心對(duì)象,用于連接服務(wù)端并發(fā)送消息)
private TcpClient clientSocket;
// 服務(wù)端IP和端口(必須與服務(wù)端完全一致,否則無(wú)法連接)
private readonly string serverIp = "127.0.0.1";
private readonly int serverPort = 8888;
public Form1()
{
InitializeComponent();
// 綁定窗體關(guān)閉事件,釋放資源
this.FormClosing += Form1_FormClosing;
}
// 「連接服務(wù)端」按鈕點(diǎn)擊事件
private void btnConnect_Click(object sender, EventArgs e)
{
try
{
// 創(chuàng)建TCP客戶端對(duì)象
clientSocket = new TcpClient();
// 連接服務(wù)端(IP和端口必須與服務(wù)端一致)
clientSocket.Connect(serverIp, serverPort);
AppendMsg("成功連接到服務(wù)端!");
// 開(kāi)啟線程接收服務(wù)端消息(本案例服務(wù)端暫只接收消息,可擴(kuò)展雙向通信)
Thread receiveThread = new Thread(ReceiveMsg);
receiveThread.IsBackground = true;
receiveThread.Start();
}
catch (Exception ex)
{
// 連接失敗時(shí)提示異常信息(常見(jiàn)原因:服務(wù)端未啟動(dòng)、端口不一致)
AppendMsg("連接失?。? + ex.Message);
}
}
// 接收服務(wù)端發(fā)送的消息(可擴(kuò)展雙向通信,目前預(yù)留)
private void ReceiveMsg()
{
try
{
// 獲取與服務(wù)端通信的網(wǎng)絡(luò)數(shù)據(jù)流
NetworkStream stream = clientSocket.GetStream();
byte[] buffer = new byte[1024]; // 數(shù)據(jù)緩沖區(qū)
int len; // 實(shí)際讀取的字節(jié)長(zhǎng)度
// 循環(huán)讀取服務(wù)端消息
while ((len = stream.Read(buffer, 0, buffer.Length)) > 0)
{
string msg = Encoding.UTF8.GetString(buffer, 0, len);
AppendMsg("服務(wù)端說(shuō):" + msg);
}
}
catch
{
// 與服務(wù)端斷開(kāi)連接時(shí)提示
AppendMsg("與服務(wù)端斷開(kāi)連接");
}
}
// 「發(fā)送消息」按鈕點(diǎn)擊事件
private void btnSend_Click(object sender, EventArgs e)
{
// 先判斷是否已連接服務(wù)端,未連接則提示
if (clientSocket == null || !clientSocket.Connected)
{
MessageBox.Show("請(qǐng)先連接服務(wù)端!");
return;
}
try
{
// 獲取輸入框中的消息,去除前后空格
string sendMsg = txtSend.Text.Trim();
if (string.IsNullOrEmpty(sendMsg)) return; // 空消息不發(fā)送
// 將字符串轉(zhuǎn)為UTF-8編碼的字節(jié)流(與服務(wù)端編碼一致)
byte[] buffer = Encoding.UTF8.GetBytes(sendMsg);
// 獲取網(wǎng)絡(luò)數(shù)據(jù)流,發(fā)送消息到服務(wù)端
NetworkStream stream = clientSocket.GetStream();
stream.Write(buffer, 0, buffer.Length);
// 顯示自己發(fā)送的消息
AppendMsg("你說(shuō):" + sendMsg);
txtSend.Clear(); // 發(fā)送后清空輸入框
}
catch (Exception ex)
{
// 發(fā)送失敗時(shí)提示異常信息
AppendMsg("發(fā)送失?。? + ex.Message);
}
}
// 窗體關(guān)閉事件:釋放客戶端資源
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
clientSocket?.Close();
}
// 跨線程安全更新界面消息(與服務(wù)端邏輯一致)
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);
}
}
}
}
四、運(yùn)行步驟(超級(jí)簡(jiǎn)單,新手也能搞定)
先啟動(dòng)「程序A(TCPServer)」:點(diǎn)擊窗體上的【啟動(dòng)監(jiān)聽(tīng)】按鈕,消息框會(huì)顯示「服務(wù)端已啟動(dòng)監(jiān)聽(tīng):127.0.0.1:8888」和「等待客戶端連接…」,說(shuō)明監(jiān)聽(tīng)成功。
再啟動(dòng)「程序B(TCPClient)」:點(diǎn)擊窗體上的【連接服務(wù)端】按鈕,消息框顯示「成功連接到服務(wù)端!」,此時(shí)程序A的消息框會(huì)顯示「客戶端已連接!」,說(shuō)明雙方連接成功。
發(fā)送消息:在程序B的「txtSend」輸入框中輸入文字(比如“Hello,服務(wù)端!”),點(diǎn)擊【發(fā)送消息】,程序B會(huì)顯示自己發(fā)送的消息,程序A會(huì)實(shí)時(shí)收到并顯示「客戶端說(shuō):Hello,服務(wù)端!」。
停止測(cè)試:程序A點(diǎn)擊【停止監(jiān)聽(tīng)】,會(huì)停止接收消息;關(guān)閉兩個(gè)程序時(shí),會(huì)自動(dòng)釋放所有資源,避免異常。
五、關(guān)鍵知識(shí)點(diǎn)說(shuō)明(新手必看)
5.1 同一臺(tái)電腦通信的核心
使用本地回環(huán)地址 127.0.0.1(無(wú)論電腦是否聯(lián)網(wǎng),都能實(shí)現(xiàn)本地通信),服務(wù)端和客戶端的端口必須完全一致(本文用8888,可自定義,建議選擇1024以上端口,避免與系統(tǒng)端口沖突)。
5.2 為什么要用線程?
TCP的AcceptTcpClient()(監(jiān)聽(tīng)連接)和 stream.Read()(讀取消息)都是「阻塞方法」,如果直接放在主線程(界面線程)中,會(huì)導(dǎo)致界面卡死,無(wú)法操作按鈕、輸入內(nèi)容,因此必須放在后臺(tái)線程中執(zhí)行。
5.3 跨線程更新界面
C# WinForm中,子線程(后臺(tái)線程)不能直接操作窗體控件(比如更新TextBox的內(nèi)容),否則會(huì)報(bào)錯(cuò),因此需要通過(guò) Invoke方法實(shí)現(xiàn)跨線程安全更新,本文中 AppendMsg方法就是專門做這件事的。
5.4 資源釋放
在窗體關(guān)閉、停止監(jiān)聽(tīng)時(shí),必須調(diào)用 Stop()、Close() 方法釋放 TcpListener、TcpClient 和 NetworkStream 的資源,避免內(nèi)存泄漏和程序異常。
六、擴(kuò)展功能(可選,按需擴(kuò)展)
本文實(shí)現(xiàn)的是「客戶端發(fā)送、服務(wù)端接收」的單向通信,可輕松擴(kuò)展以下功能:
- 雙向通信:在服務(wù)端添加一個(gè)輸入框和發(fā)送按鈕,復(fù)制客戶端的發(fā)送邏輯,即可實(shí)現(xiàn)服務(wù)端向客戶端發(fā)送消息。
- 多客戶端連接:修改服務(wù)端的監(jiān)聽(tīng)邏輯,用集合存儲(chǔ)多個(gè)客戶端的
TcpClient對(duì)象,實(shí)現(xiàn)群聊效果。 - 發(fā)送文件:通過(guò)
NetworkStream傳輸文件字節(jié)流,添加文件選擇、進(jìn)度顯示功能。 - 心跳檢測(cè):定期發(fā)送心跳包,檢測(cè)客戶端/服務(wù)端是否在線,避免連接異常斷開(kāi)。
- 消息加密:對(duì)發(fā)送的字節(jié)流進(jìn)行加密(比如AES加密),提高通信安全性。
七、常見(jiàn)問(wèn)題排查
問(wèn)題1:客戶端連接失敗,提示「無(wú)法連接到目標(biāo)主機(jī)」?
解決:先啟動(dòng)服務(wù)端,再啟動(dòng)客戶端;檢查服務(wù)端和客戶端的IP、端口是否一致。
問(wèn)題2:發(fā)送消息后,服務(wù)端接收不到?
解決:檢查編碼是否一致(本文均用UTF-8);檢查客戶端是否已成功連接服務(wù)端。
問(wèn)題3:界面卡死?
解決:確認(rèn)監(jiān)聽(tīng)、接收消息的操作是否放在了后臺(tái)線程中,是否設(shè)置了 IsBackground = true。
問(wèn)題4:關(guān)閉程序后,再次啟動(dòng)提示「地址已在使用」?
解決:端口被占用,可更換一個(gè)端口(比如9999),確保服務(wù)端和客戶端端口一致;或等待1-2分鐘,系統(tǒng)自動(dòng)釋放端口。
總結(jié)
本文提供的兩套代碼,完全獨(dú)立、可直接運(yùn)行,實(shí)現(xiàn)了同一臺(tái)電腦上兩個(gè)WinForm程序的TCP基礎(chǔ)通信,包含了線程安全、異常處理、資源釋放等核心細(xì)節(jié),適合新手學(xué)習(xí)TCP通信的基本原理,也可直接用于簡(jiǎn)單的項(xiàng)目場(chǎng)景。
如果需要擴(kuò)展功能(比如雙向通信、發(fā)送文件),可根據(jù)文中提示自行修改
到此這篇關(guān)于WinForm實(shí)現(xiàn)同一臺(tái)電腦兩個(gè)程序間的TCP通信的文章就介紹到這了,更多相關(guān)WinForm程序TCP通信內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Windows系統(tǒng)中C#調(diào)用WinRAR來(lái)壓縮和解壓縮文件的方法
這篇文章主要介紹了Windows系統(tǒng)中C#調(diào)用WinRAR來(lái)壓縮和解壓縮文件的方法,個(gè)人感覺(jué)在Windows中WinRAR相對(duì)7-zip更加穩(wěn)定一些,需要的朋友可以參考下2016-04-04
C#?PaddleOCRSharp?OCR進(jìn)行疲勞測(cè)試
PaddleOCRSharp?是百度飛槳封裝的.NET版本?OCR?dll?類庫(kù),OCR可以將圖像文件中的文本內(nèi)容進(jìn)行識(shí)別,下面我們就來(lái)看看如何通過(guò)它們實(shí)現(xiàn)疲勞測(cè)試吧2024-11-11
c# richtextbox更新大量數(shù)據(jù)不卡死的實(shí)現(xiàn)方式
這篇文章主要介紹了c# richtextbox更新大量數(shù)據(jù)不卡死的實(shí)現(xiàn)方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-04-04
C#使用TreeView控件實(shí)現(xiàn)的二叉樹(shù)泛型節(jié)點(diǎn)類及其方法
TreeView?控件在?C#?中主要用于顯示分層結(jié)構(gòu)的數(shù)據(jù),這通常是一個(gè)文件系統(tǒng)的表示,但也可以是任何具有父子關(guān)系的數(shù)據(jù)集合,本文給大家介紹了C#使用TreeView控件實(shí)現(xiàn)的二叉樹(shù)泛型節(jié)點(diǎn)類及其方法,需要的朋友可以參考下2024-03-03

