簡介這是一套面向C#桌面開發(fā)者的WinForm實(shí)例源碼合集適合初學(xué)者入門練手也適合有經(jīng)驗(yàn)的開發(fā)者查閱參考。內(nèi)容覆蓋窗體設(shè)計(jì)、控件布局、圖像處理、報(bào)表打印、系統(tǒng)信息獲取、文件讀寫、網(wǎng)絡(luò)通信、數(shù)據(jù)庫訪問、加密解密以及硬件讀寫等十余個(gè)方向每個(gè)實(shí)例都是可獨(dú)立運(yùn)行調(diào)試的小型項(xiàng)目便于理解C#語法與WinForm框架的實(shí)際用法。壓縮包為rar格式共收錄5058個(gè)文件其中cs源碼1353個(gè)、exe可執(zhí)行程序586個(gè)、resx與resources資源文件近900個(gè)另有csproj、sln等工程文件及jpg、ico、bmp等界面素材整體約40.66MB目錄按實(shí)例分門別類方便按模塊檢索。目前已有10280人學(xué)習(xí)下載無論是想快速查找某類功能的實(shí)現(xiàn)思路還是系統(tǒng)梳理WinForm開發(fā)技巧都能從中獲得可直接復(fù)用的代碼參考與排錯(cuò)啟發(fā)。1. 198個(gè)經(jīng)典C#WinForm實(shí)例源碼從跑通第一個(gè)到改出能用的上位機(jī)很多人搜「198個(gè)經(jīng)典C#WinForm實(shí)例源碼」心里想的其實(shí)不是那198個(gè)數(shù)字而是想找一批能直接編譯、能改、能抄進(jìn)自己項(xiàng)目里的WinForm代碼。我?guī)н^幾個(gè)做C#上位機(jī)的同事幾乎每個(gè)人入門時(shí)都干過同一件事把這類實(shí)例包下載下來一個(gè)個(gè)雙擊.sln能跑起來的留下報(bào)錯(cuò)的刪掉最后真正看懂的不到十個(gè)。問題不在實(shí)例本身而在于沒人告訴你這些實(shí)例該怎么用——哪些是練手的玩具哪些能直接變成產(chǎn)線工具哪些控件組合起來就是一套溫度濕度監(jiān)控系統(tǒng)或者串口收發(fā)界面。WinForm這套東西到今天依然活著而且活得挺穩(wěn)。工控上位機(jī)、內(nèi)部管理工具、設(shè)備調(diào)試面板、數(shù)據(jù)采集客戶端大量還在用WinForm因?yàn)樗峡丶湍艹鼋缑媸录Ｐ椭卑赘鶦#委托、Task、串口、TCP這些底層能力貼得近。你搜的那些熱詞——winform串口控件收發(fā)通信、winform溫度濕度監(jiān)控系統(tǒng)、c#上位機(jī)、winform industrial control——本質(zhì)上都是同一件事的不同切面用WinForm把設(shè)備數(shù)據(jù)接進(jìn)來、顯示出來、存下去。198個(gè)實(shí)例的價(jià)值是給你一堆已經(jīng)寫好的切面但你要自己拼成完整的那塊板。這篇不打算逐個(gè)點(diǎn)評198個(gè)例子那沒意義。我要做的是把這類實(shí)例源碼包拆成一條可復(fù)現(xiàn)的路徑先搞清楚一個(gè)WinForm實(shí)例從打開到跑通要過哪幾關(guān)再挑出真正有復(fù)用價(jià)值的幾類串口、DataGridView、多線程、界面美化把參數(shù)和坑講透最后給你一套判斷「這個(gè)實(shí)例值不值得抄進(jìn)項(xiàng)目」的方法。新手能照著把第一個(gè)實(shí)例跑起來并改出功能熟手能直接跳到避坑那章看血淚經(jīng)驗(yàn)。2. 把實(shí)例包跑起來環(huán)境、編譯與第一個(gè)可改的窗體拿到一個(gè)198實(shí)例的源碼包第一反應(yīng)不該是挨個(gè)打開而是先確認(rèn)你的環(huán)境能不能撐住這批代碼。這類包通常橫跨很多年從.NET Framework 2.0到4.8都有甚至混著早期Visual Studio的解決方案格式。你要做的第一件事是分類不是編譯。2.1 先看目標(biāo)框架再?zèng)Q定用哪個(gè)VS版本打開任意一個(gè)實(shí)例文件夾找.csproj文件用文本編輯器看TargetFrameworkVersion這一行。這一步?jīng)Q定了你后面所有操作?？蚣馨姹境Ｒ奦S版本能否在新VS打開處理建議v2.0 / v3.5VS2005/2008能但需重定向直接升級到4.7.2再編譯v4.0VS2010能一般可直接用v4.5 / v4.6VS2012-2015能推薦保留v4.7.2 / v4.8VS2017能優(yōu)先看這類我一般會先把所有.csproj的框架版本grep一遍把v2.0和v3.5的單獨(dú)放一個(gè)文件夾因?yàn)檫@兩類在老機(jī)器上跑得動(dòng)在新機(jī)器上經(jīng)常因?yàn)镾ystem.Core引用問題報(bào)錯(cuò)。升級框架版本比重裝老VS快得多。# 在實(shí)例包根目錄統(tǒng)計(jì)各框架版本分布 find . -name *.csproj -exec grep -h TargetFrameworkVersion {} \; | sort | uniq -c這條命令輸出的是每個(gè)框架版本出現(xiàn)了多少次。如果v4.0以上占多數(shù)說明這個(gè)包整體不算太老可以直接用當(dāng)前VS批量打開。如果v2.0占了一大半那你得有心理準(zhǔn)備至少三分之一的實(shí)例需要手動(dòng)升級或者直接放棄。2.2 用批處理批量判斷哪些解決方案能直接編譯一個(gè)個(gè)點(diǎn)開.sln太慢。我習(xí)慣先用MSBuild命令行做一次靜默編譯把能過的和不能過的分開。# 假設(shè)已安裝VS的MSBuild路徑按實(shí)際調(diào)整 MSBUILDC:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe for sln in $(find . -name *.sln); do $MSBUILD $sln /t:Build /p:ConfigurationDebug /verbosity:quiet /nologo if [ $? -ne 0 ]; then echo FAILED: $sln build_failed.txt else echo OK: $sln build_ok.txt fi done這段腳本的邏輯很直白遍歷所有.sln逐個(gè)調(diào)MSBuild編譯成功的記一個(gè)文件失敗的記另一個(gè)。參數(shù)里/verbosity:quiet是為了不讓滿屏的編譯日志淹沒有效信息/nologo去掉版權(quán)頭。跑完之后你手里就有兩份清單build_ok.txt里的實(shí)例才是你真正能動(dòng)手改的起點(diǎn)。注意有些實(shí)例依賴第三方DLL但沒有隨包提供這類會在編譯時(shí)報(bào)「找不到類型或命名空間」。遇到這種不要急著去網(wǎng)上找DLL先看實(shí)例文件夾里有沒有l(wèi)ib或packages目錄很多時(shí)候DLL就在里面只是引用路徑寫的是作者本機(jī)的絕對路徑。把引用路徑改成相對路徑就能過。2.3 第一個(gè)值得改的實(shí)例串口收發(fā)界面在能編譯的實(shí)例里優(yōu)先找?guī)erialPort的。理由很簡單串口收發(fā)是WinForm上位機(jī)最核心也最容易驗(yàn)證的功能你改完能立刻用虛擬串口工具測反饋閉環(huán)最短。打開一個(gè)串口實(shí)例后重點(diǎn)看三處SerialPort的初始化參數(shù)、DataReceived事件的處理方式、以及UI線程的更新寫法。很多老實(shí)例在這三處都有問題正好是你練手的地方。// 典型的串口初始化參數(shù)需要按實(shí)際設(shè)備改 private SerialPort _port new SerialPort(); private void InitSerialPort() { _port.PortName COM3; // 設(shè)備管理器里確認(rèn)實(shí)際端口號 _port.BaudRate 9600; // 波特率必須和設(shè)備一致不一致收到亂碼 _port.DataBits 8; // 數(shù)據(jù)位多數(shù)設(shè)備是8 _port.StopBits StopBits.One; // 停止位 _port.Parity Parity.None; // 校驗(yàn)位 _port.DataReceived OnDataReceived; _port.Open(); } private void OnDataReceived(object sender, SerialDataReceivedEventArgs e) { int len _port.BytesToRead; byte[] buf new byte[len]; _port.Read(buf, 0, len); // 注意這里在后臺線程不能直接碰控件 string text BitConverter.ToString(buf); this.BeginInvoke(new Action(() { txtRecv.AppendText(text Environment.NewLine); })); }參數(shù)說明PortName必須和你在設(shè)備管理器里看到的完全一致COM10以上的端口在有些老代碼里會因?yàn)橹苯悠醋址鲥e(cuò)需要用\\.\COM10這種寫法。BaudRate、DataBits、StopBits、Parity四項(xiàng)必須和設(shè)備手冊一致錯(cuò)一項(xiàng)就是亂碼或者收不到。DataReceived事件里最關(guān)鍵的是BeginInvoke因?yàn)樵撌录诤笈_線程觸發(fā)直接操作TextBox會拋跨線程異常這是新手最常翻車的地方。把這段跑通之后你可以試著把接收到的十六進(jìn)制轉(zhuǎn)成十進(jìn)制顯示或者加一個(gè)定時(shí)發(fā)送的功能。改到這里你就已經(jīng)不是在「看實(shí)例」而是在「用實(shí)例」了。3. 從實(shí)例里挑出能進(jìn)項(xiàng)目的四類代碼串口、表格、多線程、界面198個(gè)實(shí)例不可能都看但有幾類代碼是反復(fù)出現(xiàn)的也是實(shí)際項(xiàng)目里復(fù)用率最高的。這一章把這四類的選型理由和改造方法講清楚你以后拿到任何WinForm實(shí)例包都能按這個(gè)框架去篩。3.1 串口與TCP設(shè)備通信的兩條主干串口和TCP是WinForm上位機(jī)接設(shè)備的兩條主干。串口適合短距離、點(diǎn)對點(diǎn)、協(xié)議簡單的設(shè)備比如溫濕度傳感器、PLC調(diào)試口。TCP適合網(wǎng)絡(luò)設(shè)備、多客戶端場景熱詞里那個(gè)「c# tcplistener 多客戶端」就是典型需求。選型上我的習(xí)慣是能用串口就用串口因?yàn)檎{(diào)試簡單一根USB轉(zhuǎn)串口線加一個(gè)串口助手就能驗(yàn)證。只有設(shè)備本身是網(wǎng)口或者需要遠(yuǎn)程訪問時(shí)才上TCP。TCP的坑在于粘包和斷線重連實(shí)例里往往只給了最基礎(chǔ)的收發(fā)沒處理這兩個(gè)問題。// TCP服務(wù)端接收多客戶端的最小骨架 private TcpListener _listener; private ListTcpClient _clients new ListTcpClient(); private async Task StartServerAsync(int port) { _listener new TcpListener(IPAddress.Any, port); _listener.Start(); while (true) { TcpClient client await _listener.AcceptTcpClientAsync(); lock (_clients) { _clients.Add(client); } _ HandleClientAsync(client); // 每個(gè)客戶端獨(dú)立處理不阻塞接受循環(huán) } } private async Task HandleClientAsync(TcpClient client) { NetworkStream stream client.GetStream(); byte[] buffer new byte[4096]; while (client.Connected) { int n await stream.ReadAsync(buffer, 0, buffer.Length); if (n 0) break; // 對端關(guān)閉 byte[] data buffer.Take(n).ToArray(); // 這里要做粘包處理按協(xié)議頭長度或分隔符切分 DispatchToUI(data); } lock (_clients) { _clients.Remove(client); } client.Close(); }邏輯說明AcceptTcpClientAsync放在循環(huán)里持續(xù)接受新連接每個(gè)連接交給獨(dú)立的HandleClientAsync處理這樣多個(gè)客戶端互不阻塞。_ HandleClientAsync(client)這種丟棄Task的寫法在這里是可接受的因?yàn)楫惓?yīng)該在方法內(nèi)部處理掉。粘包處理是這段代碼沒寫全的部分實(shí)際項(xiàng)目里要根據(jù)設(shè)備協(xié)議來常見做法是固定長度頭長度字段或者用特定分隔符。參數(shù)上buffer大小4096是個(gè)經(jīng)驗(yàn)值太小會頻繁讀太大浪費(fèi)內(nèi)存。端口號要避開系統(tǒng)占用段建議用5000以上。3.2 DataGridView把List綁定成可編輯表格熱詞里「winform datagridview 將list的一列0和1的值顯示為checkbox」是個(gè)非常具體的需求背后是數(shù)據(jù)展示和編輯的通用問題。DataGridView是WinForm里最重的控件也是最容易用錯(cuò)的。綁定List最省事的方式是BindingList因?yàn)樗С肿兏ㄖ牧藬?shù)據(jù)界面會自動(dòng)刷新。如果你用普通List改完數(shù)據(jù)得手動(dòng)調(diào)Refresh。public class DeviceItem { public string Name { get; set; } public bool IsOnline { get; set; } // 0/1 映射成 CheckBox public int Value { get; set; } } private BindingListDeviceItem _items new BindingListDeviceItem(); private void SetupGrid() { dataGridView1.AutoGenerateColumns false; dataGridView1.DataSource _items; // 手動(dòng)加列控制顯示方式 dataGridView1.Columns.Add(new DataGridViewTextBoxColumn { DataPropertyName Name, HeaderText 設(shè)備名 }); dataGridView1.Columns.Add(new DataGridViewCheckBoxColumn { DataPropertyName IsOnline, HeaderText 在線 }); dataGridView1.Columns.Add(new DataGridViewTextBoxColumn { DataPropertyName Value, HeaderText 數(shù)值 }); }關(guān)鍵點(diǎn)在AutoGenerateColumns false和DataPropertyName的配合。如果你讓DataGridView自動(dòng)生成列bool類型確實(shí)會自動(dòng)變成CheckBox但列的順序和標(biāo)題你控制不了。手動(dòng)加列雖然多寫幾行但后面改起來方便。DataPropertyName必須和實(shí)體類的屬性名完全一致大小寫敏感寫錯(cuò)了列就是空的這是最常見的翻車點(diǎn)。3.3 多線程與委托別在UI線程里干重活熱詞里「c#委托」「c# task的用法」「c#委托和事件」反復(fù)出現(xiàn)說明這是很多人的知識盲區(qū)。在WinForm里這個(gè)問題具體化成一句話任何超過50毫秒的操作都不該放在UI線程里否則界面卡死。實(shí)例里常見的錯(cuò)誤寫法是在按鈕點(diǎn)擊事件里直接Thread.Sleep或者同步讀串口然后界面就白了。正確做法是用Task跑后臺邏輯用委托或BeginInvoke回UI線程更新。private async void btnStart_Click(object sender, EventArgs e) { btnStart.Enabled false; try { var result await Task.Run(() { // 這里跑耗時(shí)邏輯比如批量讀設(shè)備 return ReadAllDevices(); }); // await之后自動(dòng)回到UI線程可以直接更新控件 lblStatus.Text $讀取完成共{result.Count}條; _items new BindingListDeviceItem(result); dataGridView1.DataSource _items; } catch (Exception ex) { MessageBox.Show($讀取失敗{ex.Message}); } finally { btnStart.Enabled true; } }這段代碼的價(jià)值在于展示了async/await在WinForm里的正確用法。await Task.Run把耗時(shí)邏輯丟到線程池await之后的代碼自動(dòng)回到UI線程不需要你手動(dòng)Invoke。這比老實(shí)例里滿屏的this.Invoke(new Action(...))干凈得多。參數(shù)上btnStart.Enabled的開關(guān)是為了防止用戶連點(diǎn)這是個(gè)小細(xì)節(jié)但很實(shí)用。3.4 界面美化背景圖、儀表盤與自定義控件熱詞里「winform界面美化」「winform form窗體背景圖」「winform 儀表盤控件開源」「winform 自定義圓弧文本框 帶圖片」都指向同一個(gè)訴求WinForm默認(rèn)界面太丑想弄好看點(diǎn)。我的建議是分兩層看。第一層是低成本美化設(shè)背景圖、改字體、調(diào)顏色、用GroupBox分區(qū)。這些不需要第三方庫改屬性就行。第二層是自定義控件儀表盤、圓弧文本框這類要么找開源控件庫要么自己重寫OnPaint。// 窗體背景圖的最簡設(shè)置注意圖片路徑和布局 private void SetupBackground() { this.BackgroundImage Image.FromFile(bg.png); this.BackgroundImageLayout ImageLayout.Stretch; // 拉伸鋪滿 // 如果背景圖太花把內(nèi)容控件放到Panel里并設(shè)Panel背景半透明 panelContent.BackColor Color.FromArgb(180, 255, 255, 255); }參數(shù)說明ImageLayout有None、Tile、Center、Stretch、Zoom五種Stretch會變形Zoom保持比例但可能留白實(shí)際項(xiàng)目里Zoom更常用。半透明背景用Color.FromArgb帶alpha值實(shí)現(xiàn)180是透明度值越小越透明。注意WinForm的透明是偽透明它取的是父控件背景所以Panel必須直接放在窗體上才有效。儀表盤這類控件如果實(shí)例里帶了就研究它的OnPaint邏輯如果沒帶建議先用現(xiàn)成的開源庫不要一上來就自己畫。自己畫一個(gè)能用的儀表盤至少要處理刻度、指針、動(dòng)畫三個(gè)部分投入產(chǎn)出比不高。4. 避坑與排查實(shí)例代碼里最常見的五個(gè)翻車點(diǎn)這一章是我這些年改實(shí)例代碼踩出來的每條都按現(xiàn)象、原因、解決來寫。你照著排查能省下大量瞎試的時(shí)間。4.1 跨線程操作控件報(bào)「線程間操作無效」現(xiàn)象程序運(yùn)行后串口收到數(shù)據(jù)或者后臺線程更新界面時(shí)拋InvalidOperationException提示「線程間操作無效: 從不是創(chuàng)建控件XX的線程訪問它」。原因WinForm控件有線程親和性只有創(chuàng)建它的線程才能直接訪問。DataReceived、Task回調(diào)、Timer回調(diào)都在非UI線程上執(zhí)行。解決用Control.BeginInvoke或Invoke把更新操作封送回UI線程。BeginInvoke是異步的不阻塞后臺線程優(yōu)先用它。如果用了async/awaitawait之后的代碼本身就在UI線程不需要再Invoke這一點(diǎn)很多人搞混。4.2 串口打開報(bào)「訪問被拒絕」現(xiàn)象_port.Open()拋UnauthorizedAccessException提示拒絕訪問COM端口。原因端口號被別的程序占用了最常見的是串口助手沒關(guān)或者上一個(gè)實(shí)例的進(jìn)程還在后臺跑著沒退出。解決先在設(shè)備管理器確認(rèn)端口存在再檢查任務(wù)管理器里有沒有殘留進(jìn)程。調(diào)試時(shí)養(yǎng)成習(xí)慣每次改完代碼重新運(yùn)行前確認(rèn)上一次的調(diào)試進(jìn)程已經(jīng)停止。如果用的是虛擬串口工具確認(rèn)配對的兩端沒有同時(shí)被兩個(gè)程序打開。4.3 DataGridView綁定后改了List但界面不刷新現(xiàn)象代碼里對List做了Add或修改元素屬性DataGridView紋絲不動(dòng)。原因普通List不實(shí)現(xiàn)INotifyCollectionChangedDataGridView不知道數(shù)據(jù)變了。另外如果修改的是元素的屬性而不是集合本身還需要元素實(shí)現(xiàn)INotifyPropertyChanged。解決集合用BindingList 替代List 它自帶變更通知。元素類如果需要屬性級通知實(shí)現(xiàn)INotifyPropertyChanged接口。如果懶得改就在修改后手動(dòng)調(diào)dataGridView1.Refresh()或者重新賦DataSource但這是下策數(shù)據(jù)量大時(shí)性能差。4.4 編譯報(bào)「找不到類型或命名空間」但代碼看著沒問題現(xiàn)象某個(gè)實(shí)例編譯不過報(bào)錯(cuò)指向using語句或者類型名但代碼本身語法正確。原因缺少程序集引用或者引用的DLL路徑是作者本機(jī)的絕對路徑。老實(shí)例里這種情況特別多尤其是引用了System.Windows.Forms.DataVisualization這類需要單獨(dú)添加的。解決先看報(bào)錯(cuò)類型屬于哪個(gè)命名空間然后在「引用」里添加對應(yīng)的程序集。如果是第三方DLL在實(shí)例文件夾里搜同名文件找到后添加引用并把Copy Local設(shè)為True。絕對路徑的引用要改成相對路徑否則換臺機(jī)器就廢。4.5 界面在高DPI屏幕上模糊或錯(cuò)位現(xiàn)象在4K屏或者縮放125%的筆記本上窗體控件模糊或者布局錯(cuò)亂。原因老實(shí)例的app.manifest里沒有聲明DPI感知系統(tǒng)做了位圖拉伸。解決在項(xiàng)目里添加app.manifest取消注釋dpiAwaretrue/dpiAware這一行。如果用的是.NET Framework 4.7以上還可以在app.config里加System.Windows.Forms.ApplicationConfigurationSection配置高DPI模式。改完之后控件會清晰但布局可能需要微調(diào)因?yàn)閷?shí)際像素變了。5. 讓實(shí)例真正變成你的代碼改造、驗(yàn)證與長期維護(hù)跑通和避坑之后最后一步是把實(shí)例里的代碼變成你自己的。這一步?jīng)]有捷徑但有幾個(gè)具體技巧能讓你少走彎路。第一個(gè)技巧是「最小改造法」。不要試圖把一個(gè)實(shí)例改成完全符合你需求的樣子而是先把它跑通然后只改一個(gè)變量看效果再改下一個(gè)。比如串口實(shí)例先只改PortName確認(rèn)能收到數(shù)據(jù)再改BaudRate確認(rèn)亂碼變化最后改數(shù)據(jù)解析邏輯。每次只動(dòng)一個(gè)地方出問題能立刻定位。第二個(gè)技巧是「建一個(gè)自己的驗(yàn)證工程」。把從不同實(shí)例里抄來的代碼片段集中到一個(gè)空項(xiàng)目里每個(gè)片段配一個(gè)按鈕觸發(fā)用虛擬設(shè)備或者模擬數(shù)據(jù)驗(yàn)證。這樣你手里就有一個(gè)不斷長大的代碼庫下次做新項(xiàng)目直接從這里拿不用再翻198個(gè)文件夾。// 驗(yàn)證工程里的典型結(jié)構(gòu)一個(gè)按鈕測一個(gè)功能 private void btnTestSerial_Click(object sender, EventArgs e) { // 用虛擬串口對發(fā)數(shù)據(jù)驗(yàn)證收發(fā)邏輯 TestSerialLoopback(); } private void btnTestGrid_Click(object sender, EventArgs e) { // 造一批假數(shù)據(jù)驗(yàn)證DataGridView綁定和編輯 var fake Enumerable.Range(1, 20).Select(i new DeviceItem { Name $設(shè)備{i}, IsOnline i % 2 0, Value i * 10 }).ToList(); dataGridView1.DataSource new BindingListDeviceItem(fake); }這個(gè)驗(yàn)證工程的價(jià)值在于它把「實(shí)例代碼」和「你的理解」隔離開了。實(shí)例代碼是別人的驗(yàn)證工程里的代碼是你驗(yàn)證過的。以后遇到類似需求你信的是自己的驗(yàn)證結(jié)果不是某個(gè)實(shí)例能不能跑。第三個(gè)技巧是「給每個(gè)抄來的方法寫一行注釋記下它的邊界」。比如串口接收方法注釋里寫清楚「緩沖區(qū)最大4096超過會截?cái)唷埂覆恢С终嘲枭蠈犹幚怼埂＿@些邊界信息在實(shí)例源碼里往往沒有但恰恰是你在項(xiàng)目里最需要的。我自己的習(xí)慣是在方法頭用// 邊界:開頭寫一行時(shí)間久了這就是一份私人文檔。最后一個(gè)習(xí)慣不要迷信198這個(gè)數(shù)字。真正有價(jià)值的實(shí)例可能就二三十個(gè)剩下的要么重復(fù)要么太老要么只是演示某個(gè)控件的用法。你的目標(biāo)不是看完198個(gè)而是從里面挑出能解決你當(dāng)前問題的幾個(gè)改透驗(yàn)證然后忘掉其余的。我早期也想過「全部過一遍」結(jié)果浪費(fèi)了兩周真正記住的還不如后來針對一個(gè)串口需求深挖三天學(xué)到的多。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取