如何在 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 標準的文件 using IronPDF 僅需少量程式碼即可建立符合 PDF/UA 標準的文件。 匯入現有 PDF 檔案並將其轉換為 PDF/UA 格式,以確保無障礙存取。 本指南將示範如何使用 IronPDF 函式庫以符合無障礙標準。 您可以透過 NuGet 安裝 IronPDF,或參閱我們的快速入門指南以完成完整設定。

  1. using 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 文件匯出為符合 PDF/UA 標準的格式,請使用 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")
$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);
Imports IronPdf

' Load existing PDF
Dim 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");
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")
$vbLabelText   $csharpLabel

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

PDF/UA 輸出檔案的樣貌為何?

輸出檔案符合 PDF/UA 標準:

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

輸出 PDF:


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

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

將 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");
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")
$vbLabelText   $csharpLabel

如何驗證 PDF/UA 合規性?

輸出檔案符合 PDF/UA 標準:

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

若需外部驗證 PDF/UA 合規性,請使用 veraPDF Conformance Checker,這是一款專為 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 的 Enterprise 環境中部署 PDF/UA 解決方案時,IronPDF 能於所有平台上提供一致的成果。 此跨平台相容性可確保您的無障礙合規措施在任何部署情境下皆能無縫運作。

摘要

using 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 文件?

using IronPDF 匯出 PDF/UA 文件後,您可以透過 veraPDF 合規性檢查器軟體驗證其合規性,以確保該文件符合所有無障礙要求。

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

準備開始了嗎?
Nuget 下載 19,014,616 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。