您现在的位置：程式碼之家 >> 編程語言 > >> .NET 網頁程式設計 >> C# >> 關於C#

C# Windows Forms 應用程式架構完整解析：從 Program.cs 到 Form 事件

編輯：關於C#

理解 Windows Forms 應用程式的啟動流程、主迴圈機制、設計器生成程式碼與事件處理架構，是 WinForms 開發的基石。本文以完整範例解析每個關鍵環節。

完整程式碼結構

Program.cs：應用程式進入點

using System;
using System.Windows.Forms;

namespace FormsApp
{
    static class Program
    {
        /// 
        /// 應用程式的主入口點
        /// 
        [STAThread] // 單執行緒單元模式，WinForms 必須
        static void Main()
        {
            // 1. 啟用視覺樣式（讓控制項使用系統主題）
            Application.EnableVisualStyles();
            
            // 2. 設定文字渲染相容性（GDI+ vs GDI）
            Application.SetCompatibleTextRenderingDefault(false);
            
            // 3. 啟動訊息迴圈，執行主視窗
            Application.Run(new MainForm());
        }
    }
}

MainForm.cs：主視窗邏輯

using System;
using System.Windows.Forms;

namespace FormsApp
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent(); // 設計器生成的初始化
        }

        // 按鈕 1 點擊事件
        private void btnLeft_Click(object sender, EventArgs e)
        {
            MessageBox.Show("你點擊了左側按鈕。");
        }

        // 按鈕 2 點擊事件
        private void btnRight_Click(object sender, EventArgs e)
        {
            MessageBox.Show("你點擊了右側按鈕。");
        }
    }
}

MainForm.Designer.cs：設計器生成程式碼（通常不手動修改）

namespace FormsApp
{
    partial class MainForm
    {
        private System.ComponentModel.IContainer components = null;

        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
                components.Dispose();
            base.Dispose(disposing);
        }

        #region Windows Form Designer generated code
        private void InitializeComponent()
        {
            this.btnLeft = new Button();
            this.btnRight = new Button();
            this.SuspendLayout();
            
            // btnLeft 設定
            this.btnLeft.Location = new Point(35, 211);
            this.btnLeft.Name = "btnLeft";
            this.btnLeft.Size = new Size(75, 23);
            this.btnLeft.TabIndex = 0;
            this.btnLeft.Text = "左側按鈕";
            this.btnLeft.Click += new EventHandler(this.btnLeft_Click);
            
            // btnRight 設定
            this.btnRight.Location = new Point(167, 211);
            this.btnRight.Name = "btnRight";
            this.btnRight.Size = new Size(75, 23);
            this.btnRight.TabIndex = 1;
            this.btnRight.Text = "右側按鈕";
            this.btnRight.Click += new EventHandler(this.btnRight_Click);
            
            // Form 設定
            this.ClientSize = new Size(292, 273);
            this.Controls.Add(this.btnRight);
            this.Controls.Add(this.btnLeft);
            this.Name = "MainForm";
            this.Text = "範例程式";
            this.ResumeLayout(false);
        }
        #endregion

        private Button btnLeft;
        private Button btnRight;
    }
}

核心架構解析

1. [STAThread] 屬性

標記 `Main` 方法在**單執行緒單元 (STA)** 執行
WinForms、Clipboard、Drag-Drop、ActiveX 互通**必須** STA
若省略，可能導致剪貼簿失效、拖放失效、COM 元件異常

2. Application.EnableVisualStyles()

啟用 Windows XP+ 視覺主題（圓角按鈕、漸層背景等）
需在 `Application.Run` **之前**呼叫
對應 `Application.VisualStyleState` 可查詢狀態

3. Application.SetCompatibleTextRenderingDefault(false)

`false` (預設)：使用 GDI+ 文字渲染（品質較好、支援反鋸齒）
`true`：使用 GDI 文字渲染（舊版相容、效能稍佳）
影響 `Label`、`Button`、`TextBox` 等控制項文字顯示

4. Application.Run(Form)

啟動**訊息迴圈** - WinForms 核心機制
建立表單實例、顯示、進入迴圈處理訊息
迴圈結束條件：表單關閉、呼叫 `Application.Exit()`
單一呼叫：一般應用只呼叫一次，MDI 子視窗不另行呼叫

5. 訊息迴圈運作原理

// 簡化版訊息迴圈邏輯
while (messageLoopRunning)
{
    // 1. 取得訊息 (WM_PAINT, WM_MOUSEMOVE, WM_KEYDOWN, WM_TIMER, etc.)
    GetMessage(out MSG msg);
    
    // 2. 轉譯鍵盤訊息 (WM_KEYDOWN → WM_CHAR)
    TranslateMessage(ref msg);
    
    // 3. 分派訊息至對應視窗程序
    DispatchMessage(ref msg); // 內部呼叫 WndProc → 觸發事件
    
    // 4. 處理閒置工作
    Application.Idle += ...;
}

6. 事件處理機制

// 設計器生成的事件訂閱
this.btnLeft.Click += new EventHandler(this.btnLeft_Click);

// 等同於手動訂閱
btnLeft.Click += (sender, e) => MessageBox.Show("左側按鈕");

// 事件模式：sender (事件來源) + EventArgs (事件資料)
// 自訂事件引數
public class CustomEventArgs : EventArgs
{
    public string Message { get; set; }
    public int Value { get; set; }
}

// 觸發事件的標準模式
protected virtual void OnCustomEvent(CustomEventArgs e)
{
    CustomEvent?.Invoke(this, e);
}

偵錯追蹤流程

F11 進入 `Program.Main()`
執行 `Application.Run(new MainForm())`
進入 `MainForm` 建構函數 → `InitializeComponent()`
設計器程式碼建立控制項、設定屬性、訂閱事件
回到 `Application.Run`，進入訊息迴圈
使用者操作 → 系統訊息 → `WndProc` → 事件處理函式

常見架構模式延伸

| 模式 | 關鍵點 | |------|--------| | **單一表單** | `Application.Run(new MainForm())` | | **MDI 父視窗** | `IsMdiContainer = true`，子視窗 `MdiParent = this` | | **多執行緒 UI** | 每個 UI 執行緒需獨立 `Application.Run`，需 `SetApartmentState` | | **啟動畫面** | `MainForm_Load` 中 `ShowDialog(new SplashForm())` | | **系統匣應用** | `NotifyIcon`，`FormClosing` 取消關閉改為隱藏 |