C# 處理 WebBrowser 控制項跨域存取 iframe 內容完整方案

問題場景

WinForms WebBrowser 載入頁面包含跨域 <iframe> (如嵌入百度)。嘗試 frames[0].Document.GetElementById(...) 會拋出 UnauthorizedAccessException，瀏覽器同源策略阻擋跨域 DOM 存取。

解決原理：IWebBrowser2 + IServiceProvider

WebBrowser 底層為 ActiveX IWebBrowser2。透過 IServiceProvider.QueryService 從 IHTMLWindow2 (iframe window) 取得對應的 IWebBrowser2，再取其 Document 即可繞過同源限制 (需同進程、信任區域)。

完整輔助類別

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;
using mshtml; // 參考 Microsoft.mshtml

namespace WebBrowserTest
{
    // COM IServiceProvider 介面 (非 System.IServiceProvider)
    [ComImport, Guid("6D5140C1-7436-11CE-8034-00AA006009FA")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IServiceProvider
    {
        [PreserveSig]
        int QueryService(ref Guid guidService, ref Guid riid, [MarshalAs(UnmanagedType.Interface)] out object ppvObject);
    }

    // IWebBrowser2 關鍵成員
    [ComImport, Guid("D30C1661-CDAF-11d0-8A3E-00C04FC9E26E")]
    [TypeLibType(TypeLibTypeFlags.FOleAutomation | TypeLibTypeFlags.FDual | TypeLibTypeFlags.FHidden)]
    public interface IWebBrowser2
    {
        object Document { [return: MarshalAs(UnmanagedType.IDispatch)] get; }
        // 其他成員略...
    }

    public static class CrossDomainHelper
    {
        private static readonly Guid IID_IWebBrowserApp = new Guid("0002DF05-0000-0000-C000-000000000046");
        private static readonly Guid IID_IWebBrowser2 = new Guid("D30C1661-CDAF-11D0-8A3E-00C04FC9E26E");

        /// 

        /// 從跨域 iframe window 取得可操作的 IHTMLDocument3
        /// 
        public static IHTMLDocument3 GetDocumentFromWindow(IHTMLWindow2 htmlWindow)
        {
            if (htmlWindow == null) return null;

            // 1. 嘗試直接存取 (同域有效)
            try
            {
                return (IHTMLDocument3)htmlWindow.document;
            }
            catch (UnauthorizedAccessException) { /* 跨域，繼續 */ }
            catch (COMException) { /* 其他 COM 錯誤 */ }

            // 2. 跨域處理：透過 IServiceProvider 取得 IWebBrowser2
            try
            {
                var sp = (IServiceProvider)htmlWindow;
                object browserObj = null;
                int hr = sp.QueryService(ref IID_IWebBrowserApp, ref IID_IWebBrowser2, out browserObj);
                if (hr != 0 || browserObj == null) return null;

                var browser = (IWebBrowser2)browserObj;
                return (IHTMLDocument3)browser.Document;
            }
            catch (Exception ex)
            {
                System.Diagnostics.Debug.WriteLine($"CrossDomainHelper error: {ex}");
                return null;
            }
        }
    }
}

使用範例

private void btnTest_Click(object sender, EventArgs e)
{
    var doc = webBrowser1.Document;
    var frames = doc.Window.Frames;
    
    // 取得主頁面輸入值
    string searchText = doc.GetElementById("search").GetAttribute("value");

    // 關鍵：使用輔助類取得跨域 iframe Document
    var baiduDoc = CrossDomainHelper.GetDocumentFromWindow((IHTMLWindow2)frames[0].DomWindow);
    if (baiduDoc != null)
    {
        baiduDoc.getElementById("kw").setAttribute("value", searchText);
        baiduDoc.getElementById("su").click(); // 執行搜尋
    }
    else
    {
        MessageBox.Show("無法存取跨域 iframe");
    }
}

測試頁面 (本地 HTML)

<!DOCTYPE html>
<html>
<body>
<iframe id="baidu" width="500" height="500" src="https://www.baidu.com"></iframe>
<div>測試值：<input id="search" type="text" /></div>
</body>
</html>

關鍵點總結

現代替代方案

• CefSharp / WebView2：基於 Chromium/Edge 內核，支援現代 Web 標準、DevTools 協議、更穩定的跨域處理 (CDP 域隔離)。
• Puppeteer / Playwright：Headless 自動化測試框架，非 UI 埋入場景首選。

總結

傳統 WebBrowser (IE 內核) 跨域 iframe 存取需透過 COM IServiceProvider.QueryService 取得 IWebBrowser2.Document 繞過同源策略。代碼複雜且受 IE 保護模式影響大。新專案強烈建議改用 WebView2 (Edge Chromium) 或 CefSharp，獲得現代渲染引擎與標準化自動化 API。