C# iText7中添加Image后如何删除对应的PdfCanvas对象

你在C#环境下使用iText7处理PDF时，创建PdfCanvas调用AddImage添加图片后，不需要做特殊的手动删除操作，按以下规则处理即可：

• PdfCanvas本身是操作页面内容流的临时工具类，不属于PDF文档内的持久结构对象，仅用来封装页面内容流的写入逻辑，本身不会长期持有独占资源。

规范资源释放写法 #

PdfCanvas实现了IDisposable接口，直接用using块包裹实例生命周期即可，代码块执行完毕后会自动释放所有关联资源，不需要额外写删除逻辑：

// 进入代码块创建canvas实例，出块自动释放
using (PdfCanvas canvas = new PdfCanvas(document.GetPage(startPage)))
{
    PdfXObject pdfObject = canvas.AddImage(imageData, x, y, imgHeight, false, false);
    // 其余画布绘制操作都放在using块内执行
}

如果不用using块，只要确保canvas变量出作用域后没有其他引用持有，.NET的垃圾回收器会自动回收该托管对象，iText7会在PdfDocument关闭时统一刷新所有流数据，不会产生内存泄漏。

注意：不要混淆「释放Canvas对象」和「删除已添加的图片」 #

很多开发者会误以为释放PdfCanvas就能撤销已经添加的图片，实际上AddImage执行时已经完成了两个操作：一是把图片资源注册到页面的资源字典，二是把图片绘制指令写入了页面内容流，这些操作的结果已经持久化到PDF文档结构里，和PdfCanvas实例本身是否存在没有关系。

如果需要撤销刚添加的图片，要在操作画布时配合状态栈实现，示例代码如下：

using (PdfCanvas canvas = new PdfCanvas(document.GetPage(startPage)))
{
    // 先保存当前画布状态
    canvas.SaveState();
    PdfXObject addedImgXObject = canvas.AddImage(imageData, x, y, imgHeight, false, false);

    // 满足删除条件时回滚状态、移除资源
    if (shouldDeleteAddedImage)
    {
        // 回滚到保存点，擦除本次添加的绘制指令
        canvas.RestoreState();
        // 确认该图片XObject没有被其他页面引用时，从资源字典移除，减小文件体积
        document.GetPage(startPage).GetResources()
            .RemoveResource(addedImgXObject.GetPdfObject().GetIndirectReference());
    }
}

• 禁止手动对PdfCanvas调用非公开方法做销毁操作，也不要在using块外访问已经释放的canvas实例，会触发对象已释放的异常。

内容的提问来源于stack exchange，提问作者fadaidechengxuyuan