C# WinForms 開發復合控件完整教程—— 以自動顯示時間控件為例

復合控件 通過組合現有控件（Label + Timer 等）快速構建可復用 UI 組件。本文手把手演示：創建控件庫專案、添加構成控件、暴露屬性/事件、設計器體驗、測試專案引用、調試輸出，全流程零遺漏。

一、專案創建與命名規範

1. VS → 新建項目 → Windows Forms 控件庫 → 名稱 TimeLabel
2. 命名空間改為 MyCompany.Controls.TimeLabel
3. 類名 UserControl1 → TimeLabel（構造函數同步改名）

二、設計器添加構成控件

• 工具箱雙擊 Label → 命名 lblTime
• 工具箱雙擊 Timer → 命名 timer，Interval = 1000、Enabled = false

三、暴露屬性（封裝內部控件）

public partial class TimeLabel : UserControl
{
    public TimeLabel()
    {
        InitializeComponent();
    }

    // 僅讀：當前顯示的時間文本
    public string LabelText => lblTime.Text;

    // 讀寫：背景色
    public Color LabelBackColor
    {
        get => lblTime.BackColor;
        set => lblTime.BackColor = value;
    }

    // 可選：字體、前景色、格式化字符串等
    public Font LabelFont
    {
        get => lblTime.Font;
        set => lblTime.Font = value;
    }

    public string TimeFormat { get; set; } = "T"; // 長時間格式
}

四、核心邏輯：Timer Tick 更新時間 + 觸發自定義事件

private void TimeLabel_Load(object sender, EventArgs e)
{
    timer.Enabled = true; // 啟動計時
}

private void timer_Tick(object sender, EventArgs e)
{
    lblTime.Text = DateTime.Now.ToString(TimeFormat);
    OnTick(EventArgs.Empty); // 觸發對外事件
}

// 自定義事件：時間已更新
public event EventHandler Tick;

protected virtual void OnTick(EventArgs e)
{
    Tick?.Invoke(this, e);
}

五、測試專案引用與使用

1. 方案右鍵 → 添加 → 新建項目 → Windows Forms 應用程序 → TestTimeLabel
2. 工具箱右鍵 → 選擇項目 → .NET Framework 組件 → 瀏覽 → 選中 TimeLabel.dll
3. 拖放 TimeLabel 到 Form1，屬性窗口設置 LabelBackColor、LabelFont
4. 訂閱事件：

   public Form1()
   {
       InitializeComponent();
       timeLabel1.Tick += (s, e) => Debug.WriteLine(timeLabel1.LabelText);
   }

六、調試輸出驗證

運行測試專案，輸出窗口每秒打印一次當前時間，證明事件正常觸發、屬性正常暴露。

七、進階強化清單

八、部署與版本管理

• 發布 NuGet 包：nuget pack TimeLabel.nuspec，含 lib/net472/TimeLabel.dll、lib/net6.0-windows/TimeLabel.dll
• 強名簽名：專案屬性 → 簽名 → 勾選「為程序集簽名」
• 版本號：AssemblyVersion / AssemblyFileVersion 遵循 SemVer

九、總結

復合控件 = UserControl 容器 + 構成控件私有字段 + 公共屬性/事件封裝。關鍵原則：內部控件保持 private，只暴露必要屬性/事件，保證封裝性與安全性。掌握本文流程，即可將任何重複 UI 模式封裝為專業級復合控件。

1. 上一篇文章： C# ADO.NET 基礎數據庫操作全攻略（Access/SQL Server 通用）
2. 下一篇文章： C# 2.0 泛型與匿名方法實現自定義算法結構—— 以 MyVec<T> 為例

關於C#

C# 使用 GDI+ 繪製驗證碼完整教程：從隨機碼生成到 Session 驗證

驗證碼演進：從圖片拼接到 GDI+ 動態繪製 早期驗證碼多採

C# 與 .NET 實作分散式鎖服務：從資料庫鎖到 ZooKeeper 協調服務

背景與動機 在大型 Web 應用中，資料庫往往成為效能瓶頸。

Head First C# 中文版：設定新資料來源連線（第 31 頁）

現在需設定資料來源以使用 ContactDB 資料庫。步驟如

Head First C# 中文版：認識 Visual Studio IDE 各視窗功能（第 10 頁）

我們已標註 IDE 主要視窗與功能區域。你的筆記可能不同，