C# 使用 IViewObject 接口将网页渲染为图片

小岛来信

发布时间：2026-10-14 | 2人浏览过

原创

在 Windows 应用程序开发中，有时需要将 Web 页面渲染为图像进行存储或展示。本文介绍一种基于 C# 的方案，利用 ActiveX 组件（通常为 WebBrowser 控件）实现的 IViewObject 接口，将网页内容捕获为 Bitmap 对象。

技术原理

该方案的核心在于获取包含 HTML 内容的 COM 对象，并查询其是否实现了 IViewObject 接口。一旦成功获取该接口，便可以通过 Draw 方法将渲染结果绘制到指定的图形设备上下文（DC）中，从而生成位图。

准备条件

目标框架：.NET Framework 4.0+ 或兼容的环境，因为涉及大量的 COM Interop 操作。
依赖库：System.Drawing 用于图像处理，System.Runtime.InteropServices 用于 COM 交互。
前置对象：一个已加载网页的 COM 对象（如 WebBrowser 控件的 Document 属性）。

第1步：创建快照辅助类

目的：封装 COM 接口查询和绘图逻辑，提供统一的 API。

入口：新建 C# 类库或控制台项目。

动作：定义名为 SnapLibrary 的命名空间，并实现 Snapshot 类。该类负责查询接口、初始化画布并执行绘制。

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;
using System.Runtime.InteropServices.ComTypes;
using System.Drawing;
using System.Windows.Forms;
namespace SnapLibrary
{
  /// <summary>
  /// ActiveX 组件快照类，用于网页拍照，将网页保存成图片
  /// AcitveX 必须实现 IViewObject 接口
  /// </summary>
  public class Snapshot
  {
    /// <summary>
    /// 取快照
    /// </summary>
    /// <param name="pUnknown">Com 对象</param>
    /// <param name="bmpRect">图象大小</param>
    /// <returns></returns>
    public Bitmap TakeSnapshot(object pUnknown, Rectangle bmpRect)
    {
      // 确保传入的是有效的 COM 对象
      if (pUnknown == null || !Marshal.IsComObject(pUnknown))
        return null;

      IntPtr pViewObject = IntPtr.Zero;
      SnapLibrary.UnsafeNativeMethods.IViewObject ViewObject = null;

      // 创建内存位图画布
      Bitmap pPicture = new Bitmap(bmpRect.Width, bmpRect.Height);
      Graphics hDrawDC = Graphics.FromImage(pPicture);

      // 尝试查询 IViewObject 接口
      object hret = Marshal.QueryInterface(
          Marshal.GetIUnknownForObject(pUnknown),
          ref UnsafeNativeMethods.IID_IViewObject,
          out pViewObject);

      try
      {
        // 获取接口的托管包装
        ViewObject = Marshal.GetTypedObjectForIUnknown(
            pViewObject,
            typeof(SnapLibrary.UnsafeNativeMethods.IViewObject)
            ) as SnapLibrary.UnsafeNativeMethods.IViewObject;

        if (ViewObject != null)
        {
          // 执行绘制动作：将网页内容绘制到位图上
          ViewObject.Draw(
              (int)DVASPECT.DVASPECT_CONTENT,
              -1,
              IntPtr.Zero,
              null,
              IntPtr.Zero,
              hDrawDC.GetHdc(),
              new NativeMethods.COMRECT(bmpRect),
              null,
              IntPtr.Zero,
              0);
        }
      }
      finally
      {
        // 无论成功与否，务必释放接口指针
        if (pViewObject != IntPtr.Zero)
        {
          Marshal.Release(pViewObject);
        }
        // 释放 GDI 资源
        hDrawDC.Dispose();
      }

      return ViewObject != null ? pPicture : null;
    }
  }
}