如何使用iTextSharp读取PDF图层并复制到其他PDF页面？

我懂你现在的痛点——用iTextSharp直接复制PDF图层（也就是OCG，可选内容组）确实没那么直观，基础的PdfCopy或者PdfStamper方法不会自动处理图层的关联关系，因为图层不是独立的页面元素，它和文档的资源字典、内容流引用都绑定在一起。下面我给你梳理可行的实现思路和代码示例：

核心原理 #

PDF的图层依赖于文档目录中的OCProperties字典，每个图层对应一个OCG（可选内容组）对象。要复制图层，你需要：

1. 将源文档的OCG对象导入到目标文档中，更新目标文档的OCProperties字典
2. 确保页面内容流中的图层引用指向目标文档中对应的新OCG对象
3. 同步图层的可见性等配置

代码实现示例 #

方法1：用PdfStamper复制图层到现有PDF页面 #

这个方法适合把源PDF的图层内容添加到目标PDF的指定页面：

// 初始化源文档和目标文档读取器
string sourcePdfPath = "你的源PDF路径";
string targetPdfPath = "你的目标PDF路径";
string outputPath = "输出PDF路径";

PdfReader sourceReader = new PdfReader(sourcePdfPath);
PdfReader targetReader = new PdfReader(targetPdfPath);

using (FileStream stamperStream = new FileStream(outputPath, FileMode.Create))
using (PdfStamper stamper = new PdfStamper(targetReader, stamperStream))
{
    // 1. 导入源页面的内容（包含图层标记）到目标页面
    // 这里以源文档第1页、目标文档第1页为例
    PdfImportedPage importedPage = stamper.GetImportedPage(sourceReader, 1);
    PdfContentByte contentByte = stamper.GetOverContent(1); // 若要添加到下层用GetUnderContent
    contentByte.AddTemplate(importedPage, 0, 0);

    // 2. 复制源文档的OCG字典到目标文档
    PdfDictionary sourceOcProps = sourceReader.Catalog.GetAsDict(PdfName.OCPROPERTIES);
    if (sourceOcProps != null)
    {
        PdfDictionary targetOcProps = stamper.Writer.Catalog.GetAsDict(PdfName.OCPROPERTIES);
        // 目标文档没有OCProperties字典则创建
        if (targetOcProps == null)
        {
            targetOcProps = new PdfDictionary();
            stamper.Writer.Catalog.Put(PdfName.OCPROPERTIES, targetOcProps);
        }

        // 复制OCGS子字典（存储所有图层对象）
        PdfDictionary sourceOcGs = sourceOcProps.GetAsDict(PdfName.OCGS);
        if (sourceOcGs != null)
        {
            PdfDictionary targetOcGs = targetOcProps.GetAsDict(PdfName.OCGS);
            if (targetOcGs == null)
            {
                targetOcGs = new PdfDictionary();
                targetOcProps.Put(PdfName.OCGS, targetOcGs);
            }

            // 逐个导入OCG对象到目标文档
            foreach (PdfName ocgKey in sourceOcGs.Keys)
            {
                if (!targetOcGs.ContainsKey(ocgKey))
                {
                    PdfObject ocgObj = sourceOcGs.Get(ocgKey);
                    if (ocgObj.IsIndirect())
                    {
                        // 导入间接引用的OCG对象
                        PdfIndirectReference importedOcg = stamper.Writer.AddToBody(ocgObj).IndirectReference;
                        targetOcGs.Put(ocgKey, importedOcg);
                    }
                    else
                    {
                        // 直接复制直接对象
                        targetOcGs.Put(ocgKey, ocgObj);
                    }
                }
            }
        }

        // 可选：复制图层的可见性配置（OCG的ON状态等）
        PdfArray sourceOcOn = sourceOcProps.GetAsArray(PdfName.ON);
        if (sourceOcOn != null)
        {
            targetOcProps.Put(PdfName.ON, sourceOcOn);
        }
    }
}

sourceReader.Close();
targetReader.Close();

方法2：用PdfCopy创建新PDF并复制带图层的页面 #

如果是要合并多个PDF的图层到新文档，用PdfCopy需要额外处理OCG的导入：

string outputPath = "输出PDF路径";
List<string> filesPath = new List<string> { "源PDF1路径", "源PDF2路径" };

using (Document document = new Document())
using (FileStream outFile = new FileStream(outputPath, FileMode.Create))
{
    PdfCopy copy = new PdfCopy(document, outFile);
    document.Open();

    foreach (string fileName in filesPath)
    {
        using (PdfReader reader = new PdfReader(fileName))
        {
            // 先导入当前文档的OCG到目标文档
            PdfDictionary sourceOcProps = reader.Catalog.GetAsDict(PdfName.OCPROPERTIES);
            if (sourceOcProps != null)
            {
                PdfDictionary targetOcProps = copy.Catalog.GetAsDict(PdfName.OCPROPERTIES);
                if (targetOcProps == null)
                {
                    targetOcProps = new PdfDictionary();
                    copy.Catalog.Put(PdfName.OCPROPERTIES, targetOcProps);
                }

                PdfDictionary sourceOcGs = sourceOcProps.GetAsDict(PdfName.OCGS);
                if (sourceOcGs != null)
                {
                    PdfDictionary targetOcGs = targetOcProps.GetAsDict(PdfName.OCGS);
                    if (targetOcGs == null)
                    {
                        targetOcGs = new PdfDictionary();
                        targetOcProps.Put(PdfName.OCGS, targetOcGs);
                    }

                    foreach (PdfName key in sourceOcGs.Keys)
                    {
                        if (!targetOcGs.ContainsKey(key))
                        {
                            PdfObject obj = sourceOcGs.Get(key);
                            if (obj.IsIndirect())
                            {
                                PdfIndirectReference importedObj = copy.AddDocument(reader, obj.GetIndirectReference());
                                targetOcGs.Put(key, importedObj);
                            }
                            else
                            {
                                targetOcGs.Put(key, obj);
                            }
                        }
                    }
                }
            }

            // 复制当前文档的所有页面
            for (int i = 1; i <= reader.NumberOfPages; i++)
            {
                copy.AddPage(copy.GetImportedPage(reader, i));
            }
        }
    }
}

注意事项 #

• 复杂图层结构：如果源PDF有嵌套图层、OCMD（可选内容成员字典）等复杂结构，需要额外处理这些关联对象的导入
• 图层可见性：复制后如果图层默认不可见，检查是否同步了OCProperties中的ON数组（控制图层默认显示状态）
• iTextSharp版本：确保使用的是较新的iTextSharp版本（比如5.5.x系列），旧版本对OCG的支持不完善

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