如何通过OneNote COM对象插入PDF打印输出至指定页面

问题概述 #

已实现根据文件夹创建OneNote分区/子分区的功能，但无法将PDF插入到创建好的页面中。尝试过Graph API但受文件限制，也试过COM API的多种写法（包括PDF转图片、HTML链接）均未成功。

现有代码的核心问题 #

• HTML链接本地PDF路径：OneNote的UpdatePageContent无法直接识别本地绝对路径作为附件链接，仅会显示纯文本链接，无法关联文件。
• 注释的PDF转图片方案：未正确指定XML命名空间的使用，且生成的XML结构可能不符合OneNote的要求。
• UpdatePageContent调用参数缺失：未传入目标页面ID，导致更新操作无法定位到正确页面。

可行解决方案 #

方案1：通过COM API插入PDF打印件（转图片嵌入） #

恢复并修复注释的PDF转图片逻辑，确保XML结构符合OneNote 2013+的Schema规范：

public async Task AddPdfAsPrintout(string sectionId, string pageName, string pdfPath)
{
    if (!File.Exists(pdfPath))
    {
        throw new FileNotFoundException("指定的PDF文件不存在", pdfPath);
    }

    // 确保页面存在
    string pageId = EnsurePageExists(sectionId, pageName);
    XNamespace ns = "http://schemas.microsoft.com/office/onenote/2013/onenote";
    string currentTime = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ss.fffffffZ");
    string author = "程序自动插入";
    string authorInitials = "Auto";

    // 转换PDF为图片（需引入第三方库如PdfSharp）
    List<string> base64Images = ConvertPdfToImagesBase64(pdfPath);
    if (!base64Images.Any())
    {
        throw new InvalidOperationException("PDF转图片失败");
    }

    // 构建OEChildren节点，包含所有PDF页面图片
    var oeElements = base64Images.Select(imgBase64 => new XElement(ns + "OE",
        new XAttribute("objectID", Guid.NewGuid().ToString()),
        new XAttribute("creationTime", currentTime),
        new XAttribute("lastModifiedTime", currentTime),
        new XAttribute("author", author),
        new XAttribute("authorInitials", authorInitials),
        new XElement(ns + "Image",
            new XAttribute("objectID", Guid.NewGuid().ToString()),
            new XAttribute("format", "png"),
            new XAttribute("isPrintout", "true"),
            new XElement(ns + "Data", imgBase64)
        )
    ));

    // 构建Outline节点
    XElement outline = new XElement(ns + "Outline",
        new XAttribute("objectID", Guid.NewGuid().ToString()),
        new XAttribute("author", author),
        new XAttribute("authorInitials", authorInitials),
        new XAttribute("creationTime", currentTime),
        new XAttribute("lastModifiedTime", currentTime),
        new XElement(ns + "OEChildren", oeElements)
    );

    // 构建完整的Page更新XML
    XElement pageUpdate = new XElement(ns + "Page",
        new XAttribute("ID", pageId),
        outline
    );

    // 调用UpdatePageContent，指定Schema版本
    oneNoteApp.UpdatePageContent(pageUpdate.ToString(), DateTime.MinValue, XMLSchema.xs2013);
    Log.Information("PDF已作为打印件插入页面 {PageName}", pageName);
}

// 辅助方法：PDF转Base64图片示例（需安装PdfSharp.Drawing）
private List<string> ConvertPdfToImagesBase64(string pdfPath)
{
    List<string> base64List = new List<string>();
    using (PdfDocument document = PdfReader.Open(pdfPath, PdfDocumentOpenMode.Import))
    {
        for (int i = 0; i < document.PageCount; i++)
        {
            PdfPage page = document.Pages[i];
            using (MemoryStream ms = new MemoryStream())
            {
                // 渲染页面为PNG
                XGraphics gfx = XGraphics.FromPdfPage(page);
                Bitmap bitmap = new Bitmap((int)page.Width, (int)page.Height);
                gfx.DrawImage(XImage.FromGdiPlusImage(bitmap), 0, 0);
                bitmap.Save(ms, ImageFormat.Png);
                base64List.Add(Convert.ToBase64String(ms.ToArray()));
            }
        }
    }
    return base64List;
}

方案2：通过COM API添加PDF作为附件 #

OneNote支持直接添加文件附件，需使用正确的XML结构：

public void AddPdfAsAttachment(string sectionId, string pageName, string pdfPath)
{
    string pageId = EnsurePageExists(sectionId, pageName);
    XNamespace ns = "http://schemas.microsoft.com/office/onenote/2013/onenote";
    string currentTime = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ss.fffffffZ");
    string fileName = Path.GetFileName(pdfPath);

    // 构建Attachment节点
    XElement attachment = new XElement(ns + "OE",
        new XAttribute("objectID", Guid.NewGuid().ToString()),
        new XAttribute("creationTime", currentTime),
        new XAttribute("lastModifiedTime", currentTime),
        new XElement(ns + "Attachment",
            new XAttribute("objectID", Guid.NewGuid().ToString()),
            new XAttribute("path", pdfPath),
            new XAttribute("displayName", fileName),
            new XAttribute("isInline", "false")
        )
    );

    // 构建更新XML
    XElement pageUpdate = new XElement(ns + "Page",
        new XAttribute("ID", pageId),
        new XElement(ns + "Outline",
            new XAttribute("objectID", Guid.NewGuid().ToString()),
            new XElement(ns + "OEChildren", attachment)
        )
    );

    oneNoteApp.UpdatePageContent(pageUpdate.ToString(), DateTime.MinValue, XMLSchema.xs2013);
    Log.Information("PDF已作为附件添加到页面 {PageName}", pageName);
}

方案3：解决Graph API文件限制问题 #

如果使用Graph API遇到文件大小限制，可采用分块上传：

1. 先创建页面并获取页面ID
2. 使用PUT /me/onenote/pages/{pageId}/content分块上传PDF内容；或先将PDF上传到OneDrive，再通过共享链接嵌入到OneNote页面

关键注意事项 #

• 确保OneNote COM API的版本与安装的OneNote客户端匹配（建议使用2013+ Schema）
• PDF转图片需依赖第三方库（如PdfSharp、iTextSharp），注意遵守库的版权协议
• 添加附件时，OneNote客户端需能访问PDF的本地路径或网络共享路径

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