經典與現代融合：MFC專案整合.NET Framework托管擴展與控件宿主完整指南

一、背景動機：MFC的「代溝」與突破

MFC歷經十餘年仍是VC++核心，但面臨：無RAD設計器、缺乏.NET互操作、UI控件生態落後。解法：**開啟托管擴展 (/clr)**，在MFC專案中引入.NET世界，實現「對偶物件」模式與.NET控件宿主。

二、啟用托管擴展與對偶物件模式

專案設定

專案屬性 → C/C++ → General → Common Language Runtime Support：/clr (非純粹/安全模式)

對偶物件架構

[ MFC物件 ] ←→ [ 托管包裝物件 ] ←→ [ 其他.NET物件 ]
     ↑              ↑
  持有指標      持有指標

• MFC物件持有gcroot指向托管包裝物件
• 托管包裝物件持有MFCClass*指向原生物件
• 雙向操作：MFC透過包裝呼叫.NET API，.NET透過包裝操作MFC物件

建立托管包裝類別

// 專案加入「Managed C++ Component」→ 修改基類為Object → 清理程式碼
namespace MyProject {
    public ref class CDocWrapper {  // ref class = 托管參考型別
    public:
        CDocWrapper() {}
        // 包裝MFC文檔操作方法
    };
}

MFC類別中嵌入托管成員

#include   // gcroot定義

class CMyDoc : public CDocument {
public:
    gcroot m_pWrapper;  // 型別安全包裝

    BOOL Initialize() {
        #pragma push_macro("new")
        #undef new  // 避開MFC DEBUG_NEW巨集干擾托管new
        m_pWrapper = gcnew MyProject::CDocWrapper();
        #pragma pop_macro("new")
        m_pWrapper->SetNativeDoc(this);  // 建立反向指標
        return TRUE;
    }
};

關鍵點：托管物件必須用gcnew在CLR堆配置，不能用MFC的new (本地堆)。#pragma push/pop_macro("new")暫時移除DEBUG_NEW干擾。

三、宿主.NET控件：理論與實作

核心洞察：.NET控件本質是ActiveX控件

差別僅在註冊方式：ActiveX寫註冊表 (全域)，.NET控件放GAC或本地目錄。捕獲.NET控件資訊後，可用MFC ActiveX宿主機制 (COleControlSite) 載入。

自訂控件站點類別

class CWFControlSite : public COleControlSite {
public:
    CWFControlSite(COleControlContainer* pCnt) : COleControlSite(pCnt) {}
    // 覆寫必要虛擬函數支援.NET控件特性
};

class CWFControlWrapper : public CWnd {
public:
    IUnknown* m_pUnkControl;  // .NET控件的IUnknown
    IUnknown* GetManagedControl() { return m_pUnkControl; }
    void SetControlSite(COleControlSite* pSite) { m_pCtrlSite = pSite; }
};

通用檢視類別 CUserCtrlView

class CUserCtrlView : public CView {
    CWFControlWrapper m_Control;
protected:
    // 關鍵：對話框訊息預處理 (解決Tab鍵導航問題)
    virtual BOOL PreTranslateMessage(MSG* pMsg) {
        if (m_Control.m_pUnkControl) {
            CComQIPtr spInPlace(m_Control.m_pUnkControl);
            if (spInPlace && spInPlace->TranslateAccelerator(pMsg) == S_OK)
                return TRUE;
        }
        return CView::PreTranslateMessage(pMsg);
    }
    // 建立/銷毀控件邏輯...
};

PreTranslateMessage轉發訊息給IOleInPlaceActiveObject::TranslateAccelerator，解決.NET控件在MFC視圖中Tab鍵無法導航的經典問題。

四、完整整合流程清單

1. 專案開啟/clr支援
2. 加入托管包裝類別 (ref class)，定義雙向介面
3. MFC核心類別嵌入gcroot，gcnew建立，#pragma push_macro("new")保護
4. 實作CWFControlSite + CWFControlWrapper + CUserCtrlView宿主鏈
5. PreTranslateMessage轉發TranslateAccelerator支援鍵盤導航
6. 對話框/視圖中動態建立.NET控件實例，指派給Wrapper
7. 引用必要.NET組件 (System.Windows.Forms.dll等)，using namespace

五、避坑指南

• DEBUG_NEW衝突：托管配置區域務必#undef new
• 混合模式除錯：VS除錯器需設定「Managed Compatibility Mode」或「Mixed Mode」
• DLL地獄：.NET組件版本衝突，建議私有部署 (Copy Local) 或強命名進GAC
• 執行緒模型：UI執行緒必須STA，[STAThread]或AfxOleInit確保
• 記憶體洩漏：gcroot自動追蹤，但循環參考 (MFC↔Managed) 需手動切斷

總結

透過/clr、gcroot對偶物件模式與自訂COleControlSite宿主鏈，MFC專案可無縫整合.NET Framework豐富類庫與現代控件生態。這不僅延續MFC既有資產壽命，更為遷移至純.NET架構提供平滑過渡路徑。關鍵在於：托管/非托管邊界清晰劃分、CLR堆與本地堆正確配置、ActiveX宿主機制複用、訊息迴路正確轉發。