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

如何在 C# 中匯出 PDF/UA 格式文檔

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

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,或按照我們的快速入門指南進行完整設定。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

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

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer

[{i:(範例示範預設的 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

[{i:( ConvertToPdfUA()必須在SaveAs()之前呼叫。 SaveAsPdfUA()會自動處理轉換。

PDF/UA 輸出是什麼樣子?

輸出檔符合PDF/UA標準:

veraPDF Conformance Checker 顯示成功的 PDF/UA-1 驗證與綠色符合性確認訊息

輸出PDF:


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

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

將 HTML 呈現為 PDF/UA 時,請確保您的 HTML 遵循可存取性最佳實務:使用語意 HTML 元素、提供適當的標題層級、包含圖片的 alt 文字,並維持合理的內容流程。 IronPdf 的Chrome 渲染引擎可確保準確轉換,同時保持可訪問性特點。 如需更多關於 HTML 轉換為 PDF 的資訊,請參閱我們的 HTML to 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 Conformance Checker 顯示 PDF/UA 相容驗證成功,並帶有綠色確認訊息

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


PDF/UA 有哪些優點?

符合 PDF/UA 規範的優點不只在於符合法規要求:

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

對於使用 IronPDF 表單的組織而言,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 bots,將他對技術的熱愛與創意結合。

準備好開始了嗎?
Nuget 下載 17,570,948 | 版本: 2026.2 剛剛發布