萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 使用 WebBrowser 控制項擷取網頁截圖完整教學

適用範圍與限制

  • **僅限 Windows Forms / WPF 應用程式**(需 STA 執行緒、訊息迴圈)
  • **不適用於 ASP.NET 網站專案**(伺服器端無 UI 執行緒、無桌面互動權限)
  • 依賴 IE 渲染引擎(MSHTML),受限於 IE 版本相容性
  • 現代替代方案建議使用 Puppeteer Sharp、Playwright 或 Selenium + Headless Chrome

WinForms 實作範例(教學用)

using System;
using System.Drawing;
using System.Windows.Forms;

public class WebCapture : Form
{
    private WebBrowser _browser;
    private Button _btnCapture;
    private TextBox _txtUrl;
    private PictureBox _picResult;

    public WebCapture()
    {
        InitializeComponent();
        _browser = new WebBrowser { ScriptErrorsSuppressed = true, ScrollBarsEnabled = false };
        _browser.DocumentCompleted += Browser_DocumentCompleted;
    }

    private void InitializeComponent()
    {
        _txtUrl = new TextBox { Left = 10, Top = 10, Width = 400, Text = "https://example.com" };
        _btnCapture = new Button { Left = 420, Top = 10, Text = "擷取截圖" };
        _btnCapture.Click += (s, e) => Capture(_txtUrl.Text);
        _picResult = new PictureBox { Left = 10, Top = 50, Width = 800, Height = 600, BorderStyle = BorderStyle.FixedSingle };
        Controls.AddRange(new Control[] { _txtUrl, _btnCapture, _picResult });
        Text = "網頁截圖工具"; Width = 850; Height = 700;
    }

    private void Capture(string url)
    {
        _browser.Navigate(url);
    }

    private void Browser_DocumentCompleted(object sender, WebBrowserDocumentCompletedEventArgs e)
    {
        if (_browser.ReadyState != WebBrowserReadyState.Complete) return;

        // 等待動態內容載入(可依需求加入額外延遲或 JS 判斷)
        System.Threading.Thread.Sleep(1000);

        int width = _browser.Document.Body.ScrollRectangle.Width;
        int height = _browser.Document.Body.ScrollRectangle.Height;
        _browser.Width = width;
        _browser.Height = height;

        using (var bmp = new Bitmap(width, height))
        {
            _browser.DrawToBitmap(bmp, new Rectangle(0, 0, width, height));
            bmp.Save("Capture.png", System.Drawing.Imaging.ImageFormat.Png);
            _picResult.Image = bmp;
        }
    }

    [STAThread]
    static void Main() { Application.EnableVisualStyles(); Application.Run(new WebCapture()); }
}

關鍵技術點解析

  1. WebBrowser.DocumentCompleted 可能觸發多次(iframe、AJAX),需檢查 ReadyState == Complete 並可加入延遲。
  2. 設定 WebBrowser.Width/Height = Document.Body.ScrollRectangle 才能截取完整長頁,而非僅可視區域。
  3. DrawToBitmap 為 GDI+ 繪圖,效能與畫質受限於 IE 引擎。
  4. 必須在 [STAThread] 主執行緒執行,否則 WebBrowser 會拋出例外。

現代化替代方案比較

| 方案 | 優點 | 缺點 | |------|------|------| | **Puppeteer Sharp** | Headless Chrome、支援現代 JS/CSS、PDF 輸出、無 UI 依賴 | 需部署 Chromium、記憶體較高 | | **Playwright .NET** | 多瀏覽器支援、速度快、API 現代 | 相依較大、需安裝瀏覽器 | | **Selenium + ChromeDriver** | 生態系成熟、支援真實瀏覽器互動 | 需管理 Driver 版本、啟動較慢 | | **WebBrowser (本文)** | 無額外相依、.NET Framework 內建 | 僅限 Windows、IE 引擎老舊、無法在 Server 端執行 |

結語

若為桌面工具快速原型,WebBrowser 仍是零安裝的選擇;正式產品或伺服器端服務,**強烈建議改用 Puppeteer Sharp 或 Playwright**,獲得現代網頁相容性、穩定性與部署彈性。

copyright © 萬盛學電腦網 all rights reserved