C# 操作 Word 事件完整指南：從委派訂閱到自動化客戶端實戰

Microsoft Word 透過 COM 互操作暴露豐富的事件模型，C# 以委派為基礎實現事件訂閱。本文系統整理 Word 2000/2002/2003 三版本支援的事件清單，並提供完整的 Visual C# 自動化客戶端範例，涵蓋文件開啟/關閉/列印/儲存、視窗互動、郵件合併等核心場景。

Word 事件支援版本對照表

全版本支援（Word 2000/2002/2003）

Word 2002/2003 新增

Word 2003 專屬

（原文未列出 2003 獨有事件，通常為 XML/智慧標籤相關擴展）

C# 自動化客戶端完整實作

專案建立步驟

1. Visual Studio → 新專案 → Windows Forms App (.NET Framework)
2. 專案 → 加入參考 → COM → Microsoft Word 11.0/12.0/14.0/16.0 Object Library
3. 工具箱拖放一個 Button (button1)
4. 雙擊按鈕進入 button1_Click 撰寫代碼

核心代碼

using System;
using System.Diagnostics;
using System.Windows.Forms;
using Word = Microsoft.Office.Interop.Word;

namespace WordEventDemo
{
    public partial class Form1 : Form
    {
        private Word.Application _wordApp;

        public Form1() => InitializeComponent();

        private void button1_Click(object sender, EventArgs e)
        {
            // 1. 啟動 Word 並建立文件
            _wordApp = new Word.Application { Visible = true };
            var missing = Type.Missing;
            var doc = _wordApp.Documents.Add(ref missing, ref missing, ref missing, ref missing);
            doc.Content.Text = "Handle Events for Microsoft Word Using C#.";
            doc = null; // 釋放文件參考，避免 RCW 洩漏

            // 2. 訂閱事件（使用 ApplicationEvents4 介面）
            _wordApp.DocumentBeforeClose += OnDocumentBeforeClose;
            _wordApp.DocumentBeforeSave += OnDocumentBeforeSave;
            _wordApp.DocumentChange += OnDocumentChange;
            _wordApp.WindowBeforeDoubleClick += OnWindowBeforeDoubleClick;
            _wordApp.WindowBeforeRightClick += OnWindowBeforeRightClick;
        }

        // 3. 事件處理器
        private void OnDocumentBeforeClose(Word.Document doc, ref bool cancel)
            => Debug.WriteLine($"DocumentBeforeClose: {doc.Name}");

        private void OnDocumentBeforeSave(Word.Document doc, ref bool saveAsUI, ref bool cancel)
            => Debug.WriteLine($"DocumentBeforeSave: {doc.Name}");

        private void OnDocumentChange()
            => Debug.WriteLine("DocumentChange");

        private void OnWindowBeforeDoubleClick(Word.Selection sel, ref bool cancel)
            => Debug.WriteLine($"WindowBeforeDoubleClick: {sel.Text}");

        private void OnWindowBeforeRightClick(Word.Selection sel, ref bool cancel)
            => Debug.WriteLine($"WindowBeforeRightClick: {sel.Text}");

        // 4. 關閉時清理
        protected override void OnFormClosing(FormClosingEventArgs e)
        {
            if (_wordApp != null)
            {
                _wordApp.Quit();
                System.Runtime.InteropServices.Marshal.ReleaseComObject(_wordApp);
            }
            base.OnFormClosing(e);
        }
    }
}

關鍵技術細節深度解析

1. 事件委派簽名對應

每個事件對應專用委派類型，如 ApplicationEvents4_DocumentBeforeCloseEventHandler，參數包含 Word.Document 與 ref bool Cancel，允許取消操作。

2. RCW 釋放與記憶體管理

• 每個 COM 物件對應一個 Runtime Callable Wrapper (RCW)
• 用完需 Marshal.ReleaseComObject，否則 Word 進程殘留
• 避免「兩個點」寫法：app.Documents.Add() → 產生中間 RCW 無法釋放

3. 偵錯輸出觀察

• 執行專案 (F5) → 點擊按鈕啟動 Word
• 在 Word 中雙擊、右鍵、存檔、關閉文件
• VS → 檢視 → 其他視窗 → 輸出 → 查看事件觸發順序

4. 版本相容性處理

// 編譯時綁定特定版本 PIA，執行時需對應版本 Word
// 跨版本部署建議：
// 1. 使用晚期綁定 (dynamic / Type.InvokeMember)
// 2. 或引用最低版本 PIA (Word 2000) 並啟用「內嵌 Interop 類型」

常見坑與解決方案

進階應用場景

• 文件審計追蹤：記錄誰在何時開啟/修改/列印機密文件
• 自動備份/版本控制：DocumentBeforeSave 觸發 Git commit 或雲端同步
• 內容合規攔截：WindowBeforeDoubleClick 檢測敏感詞彙，Cancel = true 阻止操作
• 郵件合併監控：大量寄發進度追蹤、失敗重試

結語：C# 操作 Word 事件的核心在於委派訂閱模型與COM 物件生命週期管理。掌握事件清單、正確釋放 RCW、處理版本相容，即可構建穩健的 Office 自動化解決方案。下一步嘗試整合 VSTO (Visual Studio Tools for Office) 獲得更原生的開發體驗與部署優勢。