使用C# WinForms与PDFSharp创建带页面标签的PDF遇到问题

PDFSharp完全支持设置PDF页面标签，你之前的问题是没有严格遵循PDF规范的元数据结构，错误地操作了Pages字典而非Catalog字典，或者结构层级顺序不对。以下是正确的实现步骤和代码示例：

核心原理 #

PDF的页面标签元数据必须放在文档Catalog字典的/PageLabels条目下，结构层级为：

• Catalog → PageLabels字典 → /Nums数组（成对存储[起始页码(0-based), 标签规则字典]）

完整代码示例 #

using PdfSharp.Pdf;
using PdfSharp.Pdf.Advanced;

// 创建新PDF文档
PdfDocument doc = new PdfDocument();

// 添加示例页面（这里添加5页用于测试多段标签）
for (int i = 0; i < 5; i++)
{
    doc.AddPage();
}

// 1. 创建PageLabels字典并关联到Catalog
PdfDictionary pageLabelsDict = new PdfDictionary(doc);
doc.Catalog.Elements.Add("/PageLabels", pageLabelsDict);

// 2. 创建Nums数组，用于存储标签规则对
PdfArray numsArray = new PdfArray(doc);
pageLabelsDict.Elements.Add("/Nums", numsArray);

// 3. 添加第一段标签规则：第1-2页，大写罗马数字，前缀"前言-"
PdfDictionary rule1 = new PdfDictionary(doc);
rule1.Elements.Add("/S", new PdfName("/R")); // 大写罗马数字格式
rule1.Elements.Add("/P", new PdfString("前言-")); // 标签前缀
numsArray.Elements.Add(new PdfInteger(0)); // 起始页码（0对应第1页）
numsArray.Elements.Add(rule1);

// 4. 添加第二段标签规则：第3-5页，阿拉伯数字，起始编号1，前缀"正文-"
PdfDictionary rule2 = new PdfDictionary(doc);
rule2.Elements.Add("/S", new PdfName("/D")); // 阿拉伯数字格式
rule2.Elements.Add("/P", new PdfString("正文-"));
rule2.Elements.Add("/St", new PdfInteger(1)); // 起始编号（默认1可省略）
numsArray.Elements.Add(new PdfInteger(2)); // 起始页码（2对应第3页）
numsArray.Elements.Add(rule2);

// 保存文档
doc.Save("带页面标签的示例.pdf");
doc.Close();

关键注意事项 #

• PDF内部页码是0-based，设置起始页时要注意和实际页面号的转换（比如第3页对应索引2）
• /Nums数组必须是偶数个元素，每两个元素为一组：[起始页码, 标签规则字典]，支持多组规则实现分段标签
• 标签格式参数/S的可选值：
  • /D：阿拉伯数字（默认格式）
  • /R：大写罗马数字
  • /r：小写罗马数字
  • /A：大写英文字母
  • /a：小写英文字母
• /P用于设置标签前缀文本，/St用于指定编号起始值（默认从1开始）

内容的提问来源于stack exchange，提问作者Brett M.