如何使用 C# 導出 PDF UA 格式文檔

How to Export PDF/UA Format Documents in C

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF可讓您將 PDF 匯出為 PDF/UA 標準,確保殘障用戶也能存取。 本函式庫同時支援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 ,或依照我們的快速入門指南進行完整安裝。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 複製並運行這段程式碼。

    var pdf = IronPdf.PdfDocument.FromFile("input.pdf");
    pdf.SaveAsPdfUA("output_pdfua.pdf");
  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronPDF

    arrow pointer

請注意範例預設示範 PDF/UA-1。 IronPDF支援 PDF/UA-2 (ISO 14289-2:2024) - 請參閱下面的專門章節。


如何匯出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");
$vbLabelText   $csharpLabel

PDF/UA-1 和 PDF/UA-2 有什麼區別?

PDF/UA-1 (ISO 14289-1)是 2012 年發布的 PDF 文件通用無障礙標準。它為支援輔助技術和結構化內容的無障礙 PDF 文件奠定了基礎。

PDF/UA-2 (ISO 14289-2:2024)是最新版本,它增強了對現代 PDF 功能的支持,包括改進對表單欄位、註釋、多媒體內容和複雜文件結構的處理。 PDF/UA-2 在保持向後相容性的同時,更能相容於 PDF 2.0 規範,並滿足輔助功能要求。

請注意PDF/UA-2 內部使用 QPDF 實現 PDF 2.0 格式,以增強功能支援和現代 PDF 相容性。

匯出時要指定 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);
$vbLabelText   $csharpLabel

如何將文件轉換為記憶體中的 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");
$vbLabelText   $csharpLabel

請注意ConvertToPdfUA() 必須在 SaveAs() 之前呼叫。 SaveAsPdfUA() 自動處理轉換。

PDF/UA 輸出是什麼樣的?

輸出檔符合PDF/UA標準:

veraPDF 一致性檢查器顯示 PDF/UA-1 驗證成功,並顯示綠色合規性確認訊息。

輸出PDF:


如何將 HTML 直接渲染為 PDF/UA?

除了將文件匯出為 PDF/UA 標準外,還可以使用 RenderHtmlAsPdfUA 方法將 HTML 輸入直接渲染為 PDF/UA 格式。 這種方法適用於從頭開始建立新文件或處理來自 Web 應用程式的動態內容。

將 HTML 渲染為 PDF/UA 時,請確保您的 HTML 遵循可訪問性最佳實踐:使用語義化的 HTML 元素,提供正確的標題層次結構,為圖像添加替代文本,並保持邏輯內容流。 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");
$vbLabelText   $csharpLabel

如何驗證PDF/UA合規性?

輸出檔符合PDF/UA標準:

VeraPDF 一致性檢查器顯示 PDF/UA 合規性驗證成功,並顯示綠色確認訊息。

若要從外部驗證 PDF/UA 合規性,請使用 veraPDF 合規性檢查器,這是一個專為 PDF 驗證而設計的免費開源工具。 該工具可對照 PDF/UA-1 和 PDF/UA-2 標準檢查文檔,並提供有關合規性問題的詳細報告。 在 PDF 工作流程中實施輔助功能時,定期驗證至關重要。


PDF/UA有哪些優勢?

PDF/UA 合規性除了滿足法規要求外,還有其他優點:

1.增強可訪問性:螢幕閱讀器和輔助技術能夠正確解讀文件結構,方便視力障礙使用者使用。 2.提升移動體驗:文字重排功能確保文件在小螢幕上無需橫向捲動即可閱讀。 3.更佳的搜尋引擎優化:合理的文件結構能夠提升內容索引和搜尋排名。 4.面向未來的文件: PDF/UA 文件在不同平台和軟體更新後仍能維持輔助功能。 5.法律合規性:滿足政府和組織對可存取數位文件的要求

對於使用PDF 表單的組織而言,PDF/UA 合規性可確保表單欄位正確標記,並可供所有使用者存取。

如何將 PDF/UA 整合到我的工作流程中?

在文件工作流程中實施 PDF/UA 需要進行規劃。 首先要確保來源文檔結構正確。 處理現有 PDF 檔案時,可能需要在轉換之前新增元資料和結構元素。

對於大批量文件處理,可將 PDF/UA 匯出與其他IronPDF功能(如合併 PDF新增數位簽章)結合使用,以建立全面的文件管理解決方案。 PDF/UA 標準與這些功能相容,可讓您建立安全、格式專業的無障礙文件。

WindowsLinuxAzure等企業環境中部署 PDF/UA 解決方案時, IronPDF可在所有平台上提供一致的結果。 這種跨平台相容性確保您的無障礙合規工作在任何部署場景中都能無縫運作。

概括

使用IronPDF建立符合 PDF/UA 標準的文件非常簡單,對於確保數位可存取性至關重要。 無論是轉換現有 PDF 還是從 HTML 產生新文檔, IronPDF都提供了滿足無障礙標準所需的工具,同時保持文件品質和功能。 透過在文件工作流程中實施 PDF/UA,您可以確保所有使用者都能存取內容,符合法律要求,並使您的文件能夠適應不斷發展的無障礙標準。

常見問題解答

什麼是 PDF/UA,為什麼它很重要?

PDF/UA 是 PDF 文件的無障礙標準,可確保與屏幕閱讀器等輔助技術相容。IronPDF 支援 PDF/UA 匯出,協助您符合 Section 508 法規要求,讓殘障使用者也能存取文件。

如何將現有的 PDF 轉換成 PDF/UA 格式?

使用 IronPDF,您可以使用 SaveAsPdfUA 方法將現有的 PDF 轉換為 PDF/UA 格式。只需使用 PdfDocument.FromFile() 載入您的 PDF,然後調用 SaveAsPdfUA() 將其匯出為可存取的 PDF/UA 文件。

符合 PDF/UA 的好處是什麼?

透過 IronPDF 符合 PDF/UA 規範,可在小螢幕上提供文字回流、改良的導覽選項、可自訂的文字外觀、增強的搜尋功能,以及有效率的文字選擇,讓所有使用者都能更容易存取文件。

我可以指定 PDF/UA 文件的語言嗎?

是的,IronPDF 允許您在使用 SaveAsPdfUA 方法指定 PDF 文件的自然語言時填入 naturalLanguages 參數,這對於正確的螢幕閱讀器功能非常重要。

該函式庫會產生何種版本的 PDF/UA?

預設情況下,IronPDF 會以 PDF/UA-1 的形式產生 PDF/UA 輸出,這是廣泛採用的可存取 PDF 文件標準。

如何驗證我的 PDF/UA 文件?

使用 IronPDF 匯出 PDF/UA 文件後,您可以使用 veraPDF Conformance Checker 軟體驗證其一致性,以確保它符合所有無障礙要求。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 17,803,474 | 版本: 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想快速取得證據? PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。