如何在 C# 中导出 PDF/UA 格式文档
IronPDF 允许您按照 PDF/UA 标准导出 PDF,确保残疾用户的无障碍访问。 该库支持 PDF/UA-1 (ISO 14289-1) 和 PDF/UA-2 (ISO 14289-2:2024) 两种格式。 PDF/UA 遵循特定指南,包括支持诸如屏幕阅读器之类的辅助技术。 通过遵循 PDF/UA,您的 PDF 文档符合《康复法》第508条规定的可访问性要求。
PDF/UA 在小屏幕上提供文本回流、改进的导航选项、可定制的文本外观、增强的搜索功能和高效的文本选择。 这种可访问性格式对于必须遵守政府法规并确保所有用户都能访问文件的组织来说至关重要。
快速入门:生成符合 PDF/UA 规范的文档
使用 IronPDF 以最少的代码创建符合 PDF/UA 标准的文档。 导入现有 PDF 并将其转换为 PDF/UA 格式,以确保无障碍访问。 本指南演示了如何使用 IronPDF 库来满足可访问性标准。 您可以通过 NuGet 安装 IronPDF 或按照我们的快速入门指南进行完整设置。
最小工作流程(5 个步骤)
- 下载符合 PDF/UA 标准的 IronPDF C# 库。
- 导入要转换的现有PDF文档
- 根据需要编辑PDF文档
- 使用 `SaveAsPdfUA` 方法导出 PDF/UA 文档
- 使用veraPDF合规性检查器软件验证文档的合规性
如何导出 PDF/UA 文档?
要以 PDF/UA 兼容格式导出 PDF 文档,请使用 SaveAsPdfUA 方法。 导入 PDF 文档,并使用此方法将其导出为 PDF/UA 文件。您可以填写 naturalLanguages 参数来指定 PDF 文档的自然语言。 IronPDF 支持 PDF/UA-1 和 PDF/UA-2 两种格式,默认输出版本为 PDF/UA-1。
PDF/UA 标准要求适当的文档结构和元数据。 IronPDF 可以自动处理许多要求,但要确保您的源文件有正确的标题、图像的替代文本以及合理的阅读顺序。 有关高级 PDF 操作功能,请浏览我们的编辑 PDF 和设置元数据指南。
输入文件:"wikipedia.pdf"
导出 PDF/UA 需要哪些代码?
下面的示例演示了将现有 PDF 转换为 PDF/UA 格式。 这种方法适用于需要满足可访问性标准的遗留文档。 转换过程既要保留文档内容,又要添加 PDF/UA 合规性所需的可访问性结构。
:path=/static-assets/pdf/content-code-examples/how-to/pdfua-fromfile.cs
using IronPdf;
// Open PDF File
PdfDocument pdf = PdfDocument.FromFile("wikipedia.pdf");
// Export as PDF/UA compliance PDF
pdf.SaveAsPdfUA("pdf-ua-wikipedia.pdf");
Imports IronPdf
' Open PDF File
Dim pdf As PdfDocument = PdfDocument.FromFile("wikipedia.pdf")
' Export as PDF/UA compliance PDF
pdf.SaveAsPdfUA("pdf-ua-wikipedia.pdf")
PDF/UA-1 和 PDF/UA-2 有什么区别?
PDF/UA-1 (ISO 14289-1) 是最初的 PDF 文档通用无障碍标准,于 2012 年发布。它为支持辅助技术和结构化内容的无障碍 PDF 文件奠定了基础。
PDF/UA-2 (ISO 14289-2:2024) 是最新版本,增强了对现代 PDF 功能的支持,包括改进了对表单域、注释、多媒体内容和复杂文档结构的处理。 PDF/UA-2 提供了与 PDF 2.0 规范更好的兼容性,同时保持了与可访问性要求的向后兼容性。
导出时要指定 PDF/UA-2 格式,请在 SaveAsPdfUA 方法中使用 version 参数:
:path=/static-assets/pdf/content-code-examples/how-to/pdfua-pdfua2.cs
using IronPdf;
// Load existing PDF
var pdf = PdfDocument.FromFile("input.pdf");
// Export as PDF/UA-2 format
pdf.SaveAsPdfUA("output_pdfua2.pdf", PdfUaVersion.PdfUa2);
Imports IronPdf
' Load existing PDF
Dim pdf = PdfDocument.FromFile("input.pdf")
' Export as PDF/UA-2 format
pdf.SaveAsPdfUA("output_pdfua2.pdf", PdfUaVersion.PdfUa2)
如何在内存中转换为 PDF/UA-2 文件?
对于需要在保存前进行额外修改的工作流程,请先使用 ConvertToPdfUA() 在内存中转换文档。这种方法允许您应用 PDF/UA-2 合规性转换,然后在最终导出之前执行其他操作:
:path=/static-assets/pdf/content-code-examples/how-to/pdfua-convert-ua2.cs
using IronPdf;
// Open PDF File
PdfDocument pdf = PdfDocument.FromFile("input.pdf");
// Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2);
// Perform additional modifications if needed
// ...
// Save the converted document
pdf.SaveAs("output-ua2.pdf");
Imports IronPdf
' Open PDF File
Dim pdf As PdfDocument = PdfDocument.FromFile("input.pdf")
' Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2)
' Perform additional modifications if needed
' ...
' Save the converted document
pdf.SaveAs("output-ua2.pdf")
ConvertToPdfUA() 必须在 SaveAs() 之前调用。 SaveAsPdfUA() 自动处理转换。PDF/UA 输出是什么样的?
输出文件符合 PDF/UA 标准:
输出 PDF:
如何将 HTML 直接渲染为 PDF/UA?
除了将文档导出为 PDF/UA 标准外,还可以使用 RenderHtmlAsPdfUA 方法将 HTML 输入直接渲染为 PDF/UA 格式。 这种方法适用于从头开始创建新文档或处理网络应用程序中的动态内容。
在将 HTML 转换为 PDF/UA 时,请确保您的 HTML 符合可访问性最佳实践:使用语义 HTML 元素、提供适当的标题层次结构、包含图像的 alt 文本并保持合理的内容流。 IronPdf 的Chrome 渲染引擎可确保准确转换,同时保持可访问性功能。 有关 HTML 转 PDF 的更多信息,请参阅我们的 HTML 转 PDF 指南。
以下是代码示例:
哪些代码可将 HTML 渲染成 PDF/UA?
本示例展示了如何直接从 HTML 内容创建符合 PDF/UA 标准的文档。 注意使用语义 HTML 元素,如标题和段落,这对于创建可访问的 PDF 文档至关重要。 元数据标题确保文档具有正确的标识,这是 PDF/UA 合规性的要求。
:path=/static-assets/pdf/content-code-examples/how-to/pdfua-render-html-to-pdfua.cs
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
// html is a large stright above of a full html page with <html><head><style><body> etc...
var pdf = renderer.RenderHtmlAsPdfUA(@"
<!DOCTYPE html>
<html>
<head>
<title>Document</title>
</head>
<body>
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<p>Paragraph text</p>
</body>
</html>");
pdf.MetaData.Title = "v2025.1";
pdf.SaveAs("html-string-ua-ironpdf.pdf");
Imports IronPdf
Private renderer As New ChromePdfRenderer()
' html is a large stright above of a full html page with <html><head><style><body> etc...
Private pdf = renderer.RenderHtmlAsPdfUA("
<!DOCTYPE html>
<html>
<head>
<title>Document</title>
</head>
<body>
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<p>Paragraph text</p>
</body>
</html>")
pdf.MetaData.Title = "v2025.1"
pdf.SaveAs("html-string-ua-ironpdf.pdf")
如何验证 PDF/UA 合规性?
输出文件符合 PDF/UA 标准:
要从外部验证 PDF/UA 合规性,请使用 veraPDF Conformance Checker,这是一款专为 PDF 验证而设计的免费开源工具。 该工具可根据 PDF/UA-1 和 PDF/UA-2 标准检查文档,并提供有关合规性问题的详细报告。 在 PDF 工作流程中实施可访问性功能时,定期验证至关重要。
PDF/UA 有哪些优点?
PDF/UA 合规性的优势不仅仅在于满足法规要求:
1.增强可访问性:屏幕阅读器和辅助技术可为有视觉障碍的用户正确解释文档结构 2.改善移动体验:文本回流确保文档在小屏幕上可读,无需水平滚动 3.更好的搜索引擎优化:适当的文档结构可提高内容索引和可搜索性 4.Future-Proof Documents: PDF/UA 文档在不同平台和软件更新时保持可访问性功能。 5.法律合规性:满足政府和组织对无障碍数字文档的要求
对于使用 PDF 表单的组织而言,PDF/UA 合规性可确保表单字段得到正确标注,并可供所有用户访问。
如何将 PDF/UA 集成到我的工作流程中?
在文档工作流程中实施 PDF/UA 需要进行规划。 首先要确保源文件具有适当的结构。 在处理现有 PDF 时,您可能需要在转换前添加元数据和结构元素。
对于大批量文档处理,可将 PDF/UA 导出与其他 IronPDF 功能(如 合并 PDF 或 添加数字签名)相结合,创建一个全面的文档管理解决方案。 PDF/UA 标准与这些功能兼容,让您可以创建安全且格式专业的无障碍文档。
在Windows、Linux或Azure上的企业环境中部署 PDF/UA 解决方案时,IronPdf 可在所有平台上提供一致的结果。 这种跨平台兼容性可确保您的可访问性合规工作在任何部署场景下都能无缝运行。
摘要
使用 IronPDF 创建符合 PDF/UA 标准的文档简单明了,对确保数字无障碍至关重要。 无论是转换现有 PDF 还是从 HTML 生成新文档,IronPDF 都能提供必要的工具,在保持文档质量和功能的同时满足可访问性标准。 通过在文档工作流程中实施 PDF/UA,您可以确保所有用户都能访问内容,符合法律要求,并使您的文档适应未来不断发展的可访问性标准。
常见问题解答
什么是 PDF/UA,为什么它很重要?
PDF/UA 是 PDF 文档的可访问性标准,可确保与屏幕阅读器等辅助技术的兼容性。IronPDF 支持 PDF/UA 导出,帮助您满足第 508 条合规要求,使残障用户也能访问文档。
如何将现有 PDF 转换为 PDF/UA 格式?
使用 IronPDF,您可以使用 SaveAsPdfUA 方法将现有 PDF 转换为 PDF/UA 格式。只需使用 PdfDocument.FromFile() 加载 PDF,然后调用 SaveAsPdfUA() 将其导出为可访问的 PDF/UA 文档即可。
符合 PDF/UA 标准有哪些好处?
通过 IronPDF 实现 PDF/UA 合规性,可在小屏幕上提供文本回流、改进的导航选项、可定制的文本外观、增强的搜索功能和高效的文本选择,使所有用户都能更方便地访问文档。
我能否指定 PDF/UA 文档的语言?
是的,IronPDF 允许您在使用 SaveAsPdfUA 方法时填充 naturalLanguages 参数,以指定 PDF 文档的自然语言,这对于正确的屏幕阅读器功能非常重要。
该库生成什么版本的 PDF/UA?
默认情况下,IronPDF 生成的 PDF/UA 输出为 PDF/UA-1,这是广泛采用的可访问 PDF 文档标准。
如何验证我的 PDF/UA 文档?
使用 IronPDF 导出 PDF/UA 文档后,您可以使用 veraPDF Conformance Checker 软件验证其一致性,以确保它符合所有可访问性要求。

