簡(jiǎn)介這是一套面向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í)際運(yùn)用。壓縮包共收錄5058個(gè)文件以cs源碼、exe可執(zhí)行程序、resx與resources資源文件、csproj與sln工程文件為主另含dll、mdb數(shù)據(jù)庫、rpt報(bào)表、ico與bmp圖像等配套素材整體約40.66MB工程結(jié)構(gòu)完整可直接用Visual Studio打開學(xué)習(xí)。目前已有10280人學(xué)習(xí)下載無論是想快速查找某類功能的實(shí)現(xiàn)思路還是系統(tǒng)梳理WinForm開發(fā)技巧都能從中獲得可復(fù)用的代碼范例與排錯(cuò)參考。1. 198個(gè)經(jīng)典C# WinForm實(shí)例源碼從能跑到能改的距離很多人第一次接觸 WinForm 項(xiàng)目案例都是從一份打包好的源碼合集開始的。198 個(gè)經(jīng)典 C# WinForm 實(shí)例源碼這類資源價(jià)值不在于數(shù)字本身而在于它把控件用法、事件模型、界面布局、串口通信、DataGridView 綁定這些零散知識(shí)點(diǎn)壓縮成了可以直接 F5 運(yùn)行的最小工程。你打開一個(gè)實(shí)例能看到窗體設(shè)計(jì)器里的控件樹能看到按鈕點(diǎn)擊后走了哪條分支這比看文檔快得多。但問題也在這里能跑通不等于能改。多數(shù)人卡在把實(shí)例里的按鈕換成自己的業(yè)務(wù)邏輯、把寫死的路徑換成配置、把單窗體 demo 拆成可維護(hù)結(jié)構(gòu)這一步。這篇筆記就按這個(gè)路徑走先講清這類源碼合集到底該怎么讀再落到幾個(gè)高頻場(chǎng)景的改造方法最后把踩過的坑攤開說。適合已經(jīng)會(huì)拖控件、但一改就報(bào)錯(cuò)、一重構(gòu)就崩的 WinForm 開發(fā)者。2. 讀源碼合集的正確姿勢(shì)先分類再動(dòng)手拿到 198 個(gè)實(shí)例最忌諱從第一個(gè)文件夾順序往下點(diǎn)。這些實(shí)例通常按功能散落有的講控件有的講文件有的講硬件通信難度和依賴完全不同。先花半小時(shí)做分類后面能省掉大量無效編譯。2.1 按依賴類型把實(shí)例分成四類我一般會(huì)先看每個(gè)實(shí)例的引用和 using把它們分成四類。第一類是純 UI 控件演示只依賴 System.Windows.Forms 和 System.Drawing比如自定義圓弧文本框、儀表盤控件、窗體背景圖。第二類是數(shù)據(jù)與文件操作涉及 DataGridView、ListView、CSV 讀寫、文檔書簽替換。第三類是硬件與通信包括串口收發(fā)、TCP 多客戶端、OPC 連接、LED 屏顯示。第四類是框架與進(jìn)階比如委托與事件、Task 用法、上位機(jī)通用框架。分類的意義在于第一類可以隨便改改壞了也不影響運(yùn)行環(huán)境第二類要注意文件路徑和編碼第三類必須有對(duì)應(yīng)硬件或模擬器才能驗(yàn)證第四類改動(dòng)面最大容易牽一發(fā)動(dòng)全身。新手建議從第一類入手先建立“改一處、看一處”的手感。2.2 用最小改動(dòng)法驗(yàn)證一個(gè)實(shí)例是否可復(fù)用選定一個(gè)實(shí)例后不要急著加功能。先做一次最小改動(dòng)把窗體標(biāo)題改掉把某個(gè)按鈕的 Text 改掉運(yùn)行看是否正常。這一步是在確認(rèn)工程本身沒有隱藏的絕對(duì)路徑或缺失依賴。// 在 Form1 的構(gòu)造函數(shù)里InitializeComponent 之后加一行 public Form1() { InitializeComponent(); this.Text 改造驗(yàn)證 - 溫度監(jiān)控; // 改標(biāo)題驗(yàn)證工程可編譯可運(yùn)行 btnStart.Text 啟動(dòng)采集; // 改按鈕文字驗(yàn)證設(shè)計(jì)器與代碼同步 }這段代碼的作用是確認(rèn)設(shè)計(jì)器生成的代碼和手寫代碼沒有沖突。參數(shù)說明this.Text改的是窗體標(biāo)題欄btnStart.Text改的是控件顯示文字兩者都不涉及業(yè)務(wù)邏輯屬于安全改動(dòng)。如果這一步就報(bào)錯(cuò)說明工程缺少引用或目標(biāo)框架不匹配先解決環(huán)境問題再往下走。2.3 把寫死的路徑和端口抽成配置實(shí)例里最常見的壞味道是寫死路徑比如D:\data\test.csv或者寫死串口號(hào)COM3。直接改成自己的路徑能跑但換臺(tái)機(jī)器就崩。正確做法是抽到App.config或一個(gè)簡(jiǎn)單的配置類。// App.config 里加 // appSettings // add keyDataPath valuedata\record.csv/ // add keyPortName valueCOM3/ // /appSettings using System.Configuration; string dataPath ConfigurationManager.AppSettings[DataPath]; string portName ConfigurationManager.AppSettings[PortName]; // 路徑做一次存在性檢查避免第一次運(yùn)行就拋異常 string fullPath Path.Combine(AppDomain.CurrentDomain.BaseDirectory, dataPath); string dir Path.GetDirectoryName(fullPath); if (!Directory.Exists(dir)) { Directory.CreateDirectory(dir); }邏輯說明ConfigurationManager讀取的是配置文件改配置不用重新編譯。AppDomain.CurrentDomain.BaseDirectory拿到的是程序運(yùn)行目錄比寫死盤符可靠。參數(shù)說明DataPath用相對(duì)路徑PortName留給現(xiàn)場(chǎng)調(diào)試時(shí)改。這一步做完實(shí)例才算從“演示”變成“能部署”。3. 高頻場(chǎng)景改造DataGridView、串口與委托分類之后真正花時(shí)間的是幾個(gè)高頻場(chǎng)景。198 個(gè)實(shí)例里DataGridView 綁定、串口收發(fā)、委托跨線程更新 UI 這三類出現(xiàn)頻率最高也最容易翻車。下面按“先講為什么再給可抄代碼”的順序展開。3.1 DataGridView 把 List 的 0/1 列顯示成 CheckBox這是搜索里很典型的需求數(shù)據(jù)源是一個(gè)ListT其中某列是 int 類型的 0 和 1但界面上要顯示成復(fù)選框。直接綁定會(huì)顯示數(shù)字因?yàn)?DataGridView 默認(rèn)按數(shù)據(jù)類型選列樣式。正確做法是手動(dòng)添加DataGridViewCheckBoxColumn并用CellFormatting或CellValueChanged做轉(zhuǎn)換。下面給一個(gè)完整可抄的寫法。public class Device { public string Name { get; set; } public int Enabled { get; set; } // 0 或 1 } // 綁定階段 var list new ListDevice { new Device { Name 泵1, Enabled 1 }, new Device { Name 泵2, Enabled 0 } }; var table new DataTable(); table.Columns.Add(Name, typeof(string)); table.Columns.Add(Enabled, typeof(bool)); // 關(guān)鍵列類型設(shè)為 bool foreach (var d in list) { table.Rows.Add(d.Name, d.Enabled 1); } dataGridView1.AutoGenerateColumns true; dataGridView1.DataSource table;邏輯說明不直接把ListDevice綁上去而是轉(zhuǎn)成DataTable并把Enabled列聲明為bool。這樣 DataGridView 會(huì)自動(dòng)生成 CheckBox 列。參數(shù)說明AutoGenerateColumns true讓列自動(dòng)生成如果實(shí)例里已經(jīng)手動(dòng)定義了列就把DataGridViewCheckBoxColumn的DataPropertyName設(shè)為Enabled?；貙憰r(shí)注意bool轉(zhuǎn)回int別直接賦給原對(duì)象。3.2 串口收發(fā)別在 DataReceived 里直接碰控件串口實(shí)例幾乎都會(huì)踩這個(gè)坑SerialPort.DataReceived是在后臺(tái)線程觸發(fā)的直接在里面更新 TextBox 會(huì)拋跨線程異常。正確做法是用Invoke或BeginInvoke切回 UI 線程。private void SerialPort_DataReceived(object sender, SerialDataReceivedEventArgs e) { int count serialPort1.BytesToRead; byte[] buffer new byte[count]; serialPort1.Read(buffer, 0, count); string text BitConverter.ToString(buffer); // 簡(jiǎn)單展示十六進(jìn)制 // 切回 UI 線程再更新控件 this.BeginInvoke(new Action(() { txtRecv.AppendText(text Environment.NewLine); })); }邏輯說明BytesToRead先取當(dāng)前緩沖區(qū)長(zhǎng)度再Read到字節(jié)數(shù)組避免讀多或讀少。BeginInvoke把更新操作排到 UI 消息隊(duì)列不阻塞串口線程。參數(shù)說明BitConverter.ToString輸出的是帶連字符的十六進(jìn)制如果要按文本協(xié)議解析換成Encoding.ASCII.GetString或?qū)?yīng)編碼。注意串口打開前要設(shè)好BaudRate、DataBits、StopBits、Parity這些參數(shù)必須和現(xiàn)場(chǎng)設(shè)備一致否則收到的全是亂碼。3.3 委托與事件把窗體間的耦合拆開實(shí)例里常見一個(gè)窗體直接調(diào)用另一個(gè)窗體的控件改起來很痛苦。用委托和事件可以把“誰通知誰”這件事解耦。下面是一個(gè)子窗體通知主窗體的最小寫法。// 子窗體定義事件 public partial class ChildForm : Form { public event Actionstring DataSubmitted; private void btnOk_Click(object sender, EventArgs e) { DataSubmitted?.Invoke(txtInput.Text); this.Close(); } } // 主窗體訂閱 private void btnOpenChild_Click(object sender, EventArgs e) { var child new ChildForm(); child.DataSubmitted (value) { txtMain.Text value; // 主窗體自己決定怎么處理 }; child.Show(); }邏輯說明子窗體只負(fù)責(zé)“我提交了數(shù)據(jù)”不關(guān)心誰接收。主窗體通過訂閱事件拿到數(shù)據(jù)自己更新自己的控件。參數(shù)說明Actionstring表示無返回值、帶一個(gè) string 參數(shù)的委托如果要多參數(shù)就換成自定義委托或EventHandlerT。這樣改完子窗體可以復(fù)用到別的父窗體不用改內(nèi)部代碼。4. 避坑與排查那些讓實(shí)例跑不起來的細(xì)節(jié)實(shí)例源碼在別人機(jī)器上能跑到你這里報(bào)錯(cuò)八成是下面幾個(gè)原因。這一章按“現(xiàn)象 → 原因 → 解決”寫都是實(shí)際改代碼時(shí)反復(fù)遇到的。4.1 現(xiàn)象編譯報(bào)錯(cuò)“找不到類型或命名空間”原因通常是目標(biāo)框架不匹配。老實(shí)例可能基于 .NET Framework 4.0而你用的是 4.7 或 .NET 6。WinForm 在 .NET Core 之后變化較大部分 API 被移除或改名。解決右鍵項(xiàng)目看目標(biāo)框架如果是 .NET Framework 項(xiàng)目盡量用 4.7.2 或 4.8 打開如果是 .NET 6注意System.Configuration需要單獨(dú)裝 NuGet 包ConfigurationManager不再默認(rèn)可用。4.2 現(xiàn)象串口打開報(bào)“拒絕訪問”原因一般是串口被其他程序占用或者實(shí)例里寫死的 COM 口號(hào)在你機(jī)器上不存在。解決先用設(shè)備管理器確認(rèn)實(shí)際串口號(hào)再改配置。打開前加 try-catch把UnauthorizedAccessException單獨(dú)捕獲提示“串口被占用”。不要反復(fù)點(diǎn)打開按鈕先關(guān)再開。4.3 現(xiàn)象DataGridView 綁定后修改數(shù)據(jù)不生效原因可能是綁定了ListT而不是BindingListTList不會(huì)觸發(fā)變更通知。解決把數(shù)據(jù)源換成BindingListT或者像 3.1 那樣轉(zhuǎn)成DataTable。如果必須用List就在修改后重新賦值DataSource但這樣會(huì)丟失選中行體驗(yàn)差。4.4 現(xiàn)象窗體背景圖設(shè)置后閃爍嚴(yán)重原因是在OnPaintBackground里做了重繪或者背景圖太大且沒有開啟雙緩沖。解決設(shè)置this.DoubleBuffered true;背景圖提前縮放成窗體大小不要每次繪制都拉伸原圖。如果實(shí)例里用了自定義控件檢查是否在Paint事件里反復(fù)創(chuàng)建Graphics對(duì)象。4.5 現(xiàn)象調(diào)用 C 庫時(shí)報(bào) AccessViolation c0000005原因通常是 P/Invoke 的參數(shù)類型或調(diào)用約定不匹配比如把char*當(dāng)成string傳或者結(jié)構(gòu)體對(duì)齊方式不對(duì)。解決先確認(rèn) C 導(dǎo)出函數(shù)的調(diào)用約定是__stdcall還是__cdecl在DllImport里對(duì)應(yīng)寫CallingConvention。結(jié)構(gòu)體加[StructLayout(LayoutKind.Sequential)]字符串用MarshalAs(UnmanagedType.LPStr)明確指定。不要憑感覺傳參對(duì)照頭文件逐個(gè)核對(duì)。5. 從實(shí)例到項(xiàng)目把 198 個(gè)片段收成一個(gè)可維護(hù)框架改完幾個(gè)實(shí)例后你會(huì)發(fā)現(xiàn)真正缺的不是代碼而是組織方式。198 個(gè)實(shí)例是散落的零件要變成能交付的項(xiàng)目得做三件事統(tǒng)一配置、統(tǒng)一日志、統(tǒng)一異常處理。下面給一個(gè)最小可用的骨架不依賴第三方庫。5.1 用靜態(tài)類收攏全局配置和日志public static class AppCore { public static string DataDir { get; private set; } public static string LogFile { get; private set; } static AppCore() { DataDir Path.Combine(AppDomain.CurrentDomain.BaseDirectory, data); if (!Directory.Exists(DataDir)) Directory.CreateDirectory(DataDir); LogFile Path.Combine(DataDir, app.log); } public static void Log(string msg) { string line ${DateTime.Now:yyyy-MM-dd HH:mm:ss} {msg}; File.AppendAllText(LogFile, line Environment.NewLine); } }邏輯說明靜態(tài)構(gòu)造函數(shù)在第一次訪問時(shí)執(zhí)行保證目錄存在。Log用追加寫入避免覆蓋。參數(shù)說明日志文件放在 data 目錄下和業(yè)務(wù)數(shù)據(jù)分開。如果并發(fā)寫入頻繁換成帶鎖的StreamWriter或者用File.AppendAllText加lock。5.2 全局異常捕獲別讓程序直接消失WinForm 程序未處理異常會(huì)直接閃退現(xiàn)場(chǎng)很難排查。在Program.cs里掛三個(gè)事件。static void Main() { Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException); Application.ThreadException (s, e) { AppCore.Log(UI異常: e.Exception.Message); MessageBox.Show(發(fā)生錯(cuò)誤已記錄日志); }; AppDomain.CurrentDomain.UnhandledException (s, e) { AppCore.Log(非UI異常: e.ExceptionObject.ToString()); }; Application.EnableVisualStyles(); Application.Run(new MainForm()); }邏輯說明ThreadException捕獲 UI 線程異常UnhandledException捕獲其他線程異常。參數(shù)說明SetUnhandledExceptionMode必須在創(chuàng)建任何窗體之前調(diào)用。這樣即使某個(gè)實(shí)例改造后出問題也能留下日志而不是白屏。5.3 驗(yàn)證方法用一個(gè)實(shí)例走完整流程拿串口溫度監(jiān)控這個(gè)場(chǎng)景做驗(yàn)證打開串口、定時(shí)讀取、DataGridView 顯示、異常寫日志、關(guān)閉時(shí)釋放串口。跑通一遍再換一個(gè) DataGridView 綁定的實(shí)例確認(rèn)配置和日志都能復(fù)用。如果兩個(gè)實(shí)例都能在不改 AppCore 的情況下運(yùn)行說明骨架立住了。驗(yàn)證項(xiàng)檢查內(nèi)容通過標(biāo)準(zhǔn)配置讀取App.config 改路徑后是否生效不重新編譯也能換目錄日志寫入異常時(shí)是否生成 app.log文件存在且內(nèi)容帶時(shí)間戳串口釋放關(guān)閉窗體后串口是否可再次打開不報(bào)“拒絕訪問”跨線程更新串口收數(shù)據(jù)時(shí) UI 是否卡死界面可拖動(dòng)數(shù)據(jù)正常追加這套骨架不復(fù)雜但能把 198 個(gè)實(shí)例從“能跑”拉到“能改、能查、能交付”。我自己的習(xí)慣是每改一個(gè)實(shí)例就把配置和日志接進(jìn)來改到第十個(gè)的時(shí)候新實(shí)例基本十分鐘就能并入現(xiàn)有結(jié)構(gòu)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取