IRONSOFTWAREHOME
IRONSUITE所有10個程式庫只需支付2個的價格
聯絡銷售
按公司

如何使用IronPDF在C#中建立符合第508條標準和可存取的PDF

Curtis Chau
Curtis Chau
Updated: 2026年6月4日

在C# .NET中生成可存取的PDF，使用IronPDF生成符合PDF/UA標準的文件，可立即滿足第508條和WCAG 2.0 AA的要求。 IronPDF的RenderHtmlAsPdfUA方法自動將標記的內容結構、閱讀順序、替代文字處理和可存取性元資料新增到從HTML生成的PDF中，讓.NET開發者可以構建適合螢幕閱讀器的文件，適用於政府機構、醫療服務提供者和任何與聯邦合同合作的組織。

重點摘要：快速入門指南

本教程涵蓋在C# .NET中建立符合第508條標準和PDF/UA可存取的文件，從標記結構生成到表單可存取性和合規驗證。

  • **適用於誰：**在政府合同、聯邦項目或醫療/教育系統工作的.NET開發者，當PDF的可存取性是法律要求時。
  • **您將構建：**從HTML生成PDF/UA，將遺留PDF轉換為PDF/UA，語言標籤，從語義HTML生成標記結構，影像的替代文字，可存取的表格，書籤導航和標記表單字段。
  • 運行環境：.NET 10, .NET 8 LTS, .NET Framework 4.6.2+ 和 .NET Standard 2.0。
  • **何時使用此方法：**當您的PDF必須通過第508條審核，PDF/UA (ISO 14289)驗證或WCAG 2.0 AA要求時。
  • **技術上為何重要：**標準PDF缺乏語義結構。 IronPDF從格式良好的HTML自動構建出螢幕閱讀器所需的標記內容樹。

只需幾行程式碼即可建立符合第508條標準的PDF/UA文件：

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Copy and run this code snippet.

    using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdfUA("<html lang='en'><body><h1>Accessible PDF</h1></body></html>");
pdf.SaveAs("accessible-document.pdf");
    C#

  3. 3Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

在您購買或註冊IronPDF的30天試用後，請在應用程式的開頭新增您的授權金鑰。

IronPdf.License.LicenseKey = "KEY";

Start using IronPDF in your project today with a free trial.

First Step:
arrow pointer
NuGetInstall with NuGet

PM > Install-Package IronPdf

Install IronPDF by running the command above in the NuGet Package Manager Console, or search for the package in the NuGet Package Manager.
內容目錄

什麼是第508條合規，為什麼對PDF重要？

第508條指的是1973年《復健法》的1998年修正案。這項聯邦法律要求所有由聯邦機構開發、採購、維護或使用的電子和資訊技術必須對殘障人士可存取。 其範圍超出了政府辦公室本身。 任何從聯邦獲得資助、與聯邦機構簽訂合同或向政府機構提供技術服務的組織也必須合規。

實際影響是重大的。 為聯邦醫療計劃開發軟體的承包商不能僅僅交付在螢幕上看起來正確的PDF報告。 這些文件必須能被螢幕閱讀器讀取，並且可以通過鍵盤導航，且結構化的方式讓輔助技術可翻譯。 未能滿足這些要求可能導致交付品被拒絕、合同丟失及潛在的法律行動。

PDF在可存取性上呈現出獨特的挑戰。 與擁有內建可存取性功能的HTML網頁不同，PDF文件是自包文件，必須攜帶其自身的結構資訊。 一個在視覺上看起來完美的PDF，如果缺乏適當的標籤、邏輯閱讀順序或影像的替代文字，可能對依賴螢幕閱讀器的人來說是完全不可用的。

不合規的後果不僅限於法律風險。 製作不可存取文件的組織事實上排除了它們目標受眾中的一大部分。 根據世界衛生組織的資料，全球約16%的人口經歷某種形式的殘疾。 對於政府服務和聯邦資助的計劃來說，排除這些人不僅是不好的做法，更是違反了民權保護。

什麼是PDF/UA和WCAG，它們與第508條有何關聯？

了解不同可存取性標準的關係有助於澄清開發人員實際需要實施的內容。 討論可存取PDF時有三個關鍵標準：第508條、WCAG和PDF/UA。

網頁內容可存取指南，通常稱為WCAG，源自世界萬維網聯盟。 這些指南為使數位內容可感知、可操作、可理解且穩固制定了原則。雖然WCAG主要為網頁內容設計，但其原則同樣適用於PDF文件。 修訂後的第508條標準於2017年更新，直接將WCAG 2.0 AA級別作為合規的技術基準。 這意味著滿足WCAG 2.0 AA要求實際上相當於滿足電子文件的第508條要求。

PDF/UA，即PDF/Universal Accessibility，是ISO標準（ISO 14289），專為可存取的PDF文件設計。 WCAG描述了可存取內容應達到的目標，而PDF/UA則具體規定PDF文件必須如何結構化來實現這些目標。 該標準定義了標記內容、元資料、語言規範、替代文字等數十種技術要素的要求。

將這些標準視為互補的層次。 WCAG確立了使用者所需的可存取性成果。 PDF/UA則提供了在PDF格式中實現這些成果的技術規範。 第508條建立了法律授權，要求遵循WCAG，而WCAG則指向PDF/UA作為PDF文件的實施路徑。

對於開發者而言，實際的啟示非常明確。 建構符合PDF/UA的文件就滿足了第508條合規的技術要求。 IronPDF通過其內建的可存取性功能處理了許多這些複雜事項，使您能專注於內容，而程式庫管理底層的PDF結構。

如何在C#中將現有PDF轉換為PDF/UA格式？

許多組織擁有在可存取性成為優先考量之前建立的PDF文件庫。 而非從頭重建這些文件，IronPDF允許您將標準PDF轉換為PDF/UA格式。 該轉換過程新增了與輔助技術相容所需的標記結構和元資料。

該轉換使用PdfDocument物件，並將其導出為PDF/UA格式。 以下是完整的工作範例。

輸入PDF

在此範例中，我們使用sample-document.pdf，一個沒有可存取功能的標準PDF，代表需要轉換的典型遺留文件。

下述程式碼載入現有的PDF文件，使用SaveAsPdfUA()來導出具有PDF/UA-1合規性的新版本。 IronPDF自動分析文件結構並新增所需的標記內容、元資料和可存取性標記。

using IronPdf;
using System;

string inputPath = "document.pdf";
string outputPath = "document-accessible.pdf";

// Load the existing PDF document
PdfDocument pdf = PdfDocument.FromFile(inputPath);

// Export as PDF/UA compliant document
// The method automatically adds required accessibility structure
pdf.SaveAsPdfUA(outputPath);

Console.WriteLine($"Successfully converted {inputPath} to PDF/UA format.");

對於最初使用lang屬性從HTML渲染的文件，語言規範在PDF/UA結構中保留。 以下範例顯示了如何從HTML源持續語言標記。

輸入PDF

此範例使用benefits-summary.pdf，一份需要可存取性轉換的福利文件，語言保存在其原始的HTML源中。

程式碼載入PDF並調用SaveAsPdfUA()進行轉換。 原始HTML lang屬性的語言規範在PDF/UA結構中保留，確保螢幕閱讀器使用正確的發音規則。

using IronPdf;
using System;

string inputPath = "document.pdf";
string outputPath = "document-accessible.pdf";

PdfDocument pdf = PdfDocument.FromFile(inputPath);

// Language is specified via the lang attribute in the HTML source.
// The PDF/UA structure preserves the language for screen readers.
pdf.SaveAsPdfUA(outputPath);

Console.WriteLine("Conversion complete with language specification.");

IronPDF預設生成PDF/UA-1輸出，這是廣泛採用的標準版本。 轉換過程分析現有的PDF結構，並為標題、段落、列表和其他內容元素新增適當的標籤。 自動轉換對許多文件非常有效，但複雜的佈局或掃描影像可能需要額外的人工干預，以達到完全合規。

如何將HTML直接渲染為可存取的PDF/UA文件？

轉換現有PDF解決的是遺留內容，但新文件從一開始就考慮可存取性更有益。 IronPDF的RenderHtmlAsPdfUA方法直接從HTML輸入生成符合標準的輸出。 此方法利用格式良好的HTML中已存在的語義結構來建立結構良好的PDF。

以下範例演示了從HTML字串渲染為可存取的PDF。

程式碼建立一個MetaData.Title設置文件標題，並保存合規輸出。 HTML元素上的lang='en'屬性持續到PDF中以供螢幕閱讀器語言檢測。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <meta charset='UTF-8'>
    <title>Quarterly Financial Report</title>
    <style>
        body { font-family: Arial, sans-serif; line-height: 1.6; }
        h1 { color: #333; }
        h2 { color: #555; margin-top: 20px; }
        p { margin-bottom: 15px; }
        table { border-collapse: collapse; width: 100%; margin: 20px 0; }
        th, td { border: 1px solid #ddd; padding: 12px; text-align: left; }
        th { background-color: #f4f4f4; }
    </style>
</head>
<body>
    <h1>Q4 2024 Financial Summary</h1>
    <p>This report provides an overview of financial performance for the fourth quarter.</p>

    <h2>Revenue Highlights</h2>
    <p>Total revenue increased by 12% compared to the previous quarter, driven primarily by expansion in the enterprise segment.</p>

    <h2>Expense Analysis</h2>
    <p>Operating expenses remained stable, with a slight reduction in administrative costs offset by increased investment in research and development.</p>
</body>
</html>";

// Render directly to PDF/UA format
PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

// Set additional metadata for accessibility
pdf.MetaData.Title = "Q4 2024 Financial Summary";

pdf.SaveAs("financial-report-accessible.pdf");

Console.WriteLine("Accessible PDF created successfully.");

輸出PDF

上述程式碼產生了一個語義結構的PDF/UA文件：

注意HTML中包括在html元素上的lang屬性。 此屬性持續到PDF中，有助於螢幕閱讀器識別文件語言。 語義HTML元素如h1、h2和p直接轉換為相應的PDF標籤，建立出可讓輔助技術導航的邏輯文件結構。

對於呈現HTML文件或URLs而非字串，IronPDF提供相應的方法。

下述程式碼顯示了兩種方法：RenderUrlAsPdf()從網頁URL獲取並渲染內容。 兩種方法都生成標準PDF，然後使用SaveAsPdfUA()轉換為PDF/UA格式。 這種兩步法在您需要在可存取性轉換之前應用額外處理時非常有效。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render from an HTML file on disk
PdfDocument pdfFromFile = renderer.RenderHtmlFileAsPdf("report.html");

// Convert the rendered PDF to PDF/UA format
pdfFromFile.SaveAsPdfUA("report-accessible.pdf");

// Render from a web URL
PdfDocument pdfFromUrl = renderer.RenderUrlAsPdf("https://example.com");

// Convert to accessible format
pdfFromUrl.SaveAsPdfUA("webpage-accessible.pdf");

如何設置文件元資料以符合可存取性要求？

PDF元資料在可存取性上發揮多種作用。 輔助技術公告文件屬性如標題和作者以幫助使用者識別閱讀內容。 搜尋引擎和文件管理系統使用元資料進行索引和檢索。 合規驗證器檢查是否填充了所需的元資料字段。

IronPDF通過PdfDocument物件的MetaData屬性展示元資料。 以下屬性最相關於可存取性。

輸入PDF

此範例使用enrollment-guide-draft.pdf，一份草稿福利報名指南，需要全面的元資料以符合集性合規和文件管理要求。

程式碼載入現有PDF，並配置所有關鍵元資料屬性：Creator（起始應用程式），和日期戳。 最後，SaveAsPdfUA()以儲存元資料和PDF/UA可存取性結構的情況下導出文件。

using IronPdf;
using System;

PdfDocument pdf = PdfDocument.FromFile("document.pdf");

// Set the document title - critical for accessibility
// Screen readers announce this when opening the document
pdf.MetaData.Title = "Employee Benefits Enrollment Guide 2024";

// Author information helps identify document source
pdf.MetaData.Author = "Human Resources Department";

// Subject provides a brief description
pdf.MetaData.Subject = "Guide to selecting and enrolling in employee benefit programs";

// Keywords improve searchability
pdf.MetaData.Keywords = "benefits, enrollment, health insurance, retirement, HR";

// Creator identifies the originating application
pdf.MetaData.Creator = "Benefits Portal v3.2";

// Set document dates
pdf.MetaData.CreationDate = DateTime.Now;
pdf.MetaData.ModifiedDate = DateTime.Now;

// Save as PDF/UA with complete metadata
pdf.SaveAsPdfUA("document-accessible.pdf");

Console.WriteLine("Document metadata configured for accessibility.");

Title屬性應特別注意。 PDF查看器可以在標題欄和標籤顯示文件名或文件標題。 為了可存取性，應顯示文件標題，因為它提供有意義的上下文。 像"員工福利報名指南2024"這樣的標題比"doc_final_v3_revised.pdf"這樣的文件名有用得多。

從HTML建立新PDF時，您可以在保存前設置元資料。

程式碼直接使用PdfDocument物件上配置完整的元資料屬性。 此方法在單一工作流程中嵌入可存取性結構和元資料，非常適合生成新的合規文件。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"
<!DOCTYPE html>
<html lang='en'>
<head><title>Policy Document</title></head>
<body>
    <h1>Information Security Policy</h1>
    <p>This document outlines security requirements for all employees.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(html);

// Configure comprehensive metadata
pdf.MetaData.Title = "Information Security Policy";
pdf.MetaData.Author = "IT Security Team";
pdf.MetaData.Subject = "Corporate security requirements and guidelines";
pdf.MetaData.Keywords = "security, policy, compliance, data protection";
pdf.MetaData.Creator = "Policy Management System";
pdf.MetaData.CreationDate = DateTime.Now;
pdf.MetaData.ModifiedDate = DateTime.Now;

pdf.SaveAs("security-policy-accessible.pdf");

如何為螢幕閱讀器指定文件語言？

語言規範是影響內容如何被語音化的基本可存取性要求。 當輔助技術遇到文字時，它使用指定的語言來選擇合適的發音規則、語音和閱讀模式。 沒有語言規範的文件迫使軟體猜測，通常會產生混亂或不可理解的音訊輸出。

為符合PDF/UA，文件必須聲明其主要語言。 IronPDF通過HTML源中的lang屬性處理此問題，該屬性保留在PDF/UA輸出中。

程式碼展示了兩個語言場景。 第一個場景渲染具有lang='es'。 SaveAsPdfUA()在輸出中保留。 這確保了螢幕閱讀器應用正確的發音規則給文件的主要語言。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head><title>Annual Report</title></head>
<body>
    <h1>Annual Report 2024</h1>
    <p>This report summarizes organizational activities and financial performance.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

// Language is set via lang='en' in the HTML; SaveAsPdfUA preserves it
pdf.SaveAsPdfUA("annual-report.pdf");

string htmlContentEs = @"
<!DOCTYPE html>
<html lang='es'>
<head><title>Informe Anual</title></head>
<body>
    <h1>Informe Anual 2024</h1>
    <p>Este informe resume las actividades organizacionales y el desempeño financiero.</p>
</body>
</html>";

PdfDocument pdfEs = renderer.RenderHtmlAsPdfUA(htmlContentEs);

// Language is set via lang='es' in the HTML; SaveAsPdfUA preserves it
pdfEs.SaveAsPdfUA("informe-anual.pdf");

IronPDF透過標準HTML lang屬支持語言規範。 常見的語言程式碼包含ar（阿拉伯語），以及許多其他語言。

對於含有多種語言的文件，主要文件語言應反映主要內容。 輔助技術可以很好地處理偶爾的外語短語，但含有大量多種語言內容的文件呈現出更加複雜的挑戰，可能需要專門的方法。

如何從HTML建立可存取的標記PDF結構？

標記PDF結構構成了可存取性的骨幹。 標籤定義了內容的邏輯組織，分辨標題與段落，識別列表及列表項，標記表格並建立閱讀順序。 如果沒有正確的標籤，輔助技術就無法將文件結構傳達給使用者。

使用IronPDF建立標記良好的PDF的最有效方法是從語義HTML開始。 Chromium渲染引擎在轉換為PDF時保留HTML結構，將HTML元素轉換為對應的PDF標籤。 編寫良好的HTML自動產生良好的PDF結構。

考慮以下範例，展示了正確的語義標記。

程式碼構建了具有清晰標題層次結構的HTML文档（li）來表示有序序列。 RenderHtmlAsPdfUA()方法將這些語義元素轉換為相應的PDF標籤，輔助技術可進行導航。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <title>Project Proposal</title>
    <style>
        body { font-family: Georgia, serif; line-height: 1.8; max-width: 800px; margin: 0 auto; padding: 20px; }
        h1 { font-size: 28px; border-bottom: 2px solid #333; padding-bottom: 10px; }
        h2 { font-size: 22px; color: #444; margin-top: 30px; }
        h3 { font-size: 18px; color: #666; }
        ul, ol { margin-left: 20px; }
        li { margin-bottom: 8px; }
    </style>
</head>
<body>
    <h1>Website Redesign Proposal</h1>

    <h2>Executive Summary</h2>
    <p>This proposal outlines a comprehensive redesign of the corporate website to improve user experience, accessibility, and conversion rates.</p>

    <h2>Project Objectives</h2>
    <p>The redesign aims to achieve several key goals:</p>
    <ul>
        <li>Improve mobile responsiveness across all device types</li>
        <li>Achieve WCAG 2.1 Level AA compliance for accessibility</li>
        <li>Reduce page load times by 40 percent</li>
        <li>Increase conversion rates through improved user flows</li>
    </ul>

    <h2>Implementation Timeline</h2>
    <p>The project will proceed in three phases:</p>
    <ol>
        <li>Discovery and planning: weeks one through four</li>
        <li>Design and development: weeks five through twelve</li>
        <li>Testing and launch: weeks thirteen through sixteen</li>
    </ol>

    <h3>Phase One Details</h3>
    <p>The discovery phase includes stakeholder interviews, competitive analysis, and technical assessment of the current platform.</p>

    <h3>Phase Two Details</h3>
    <p>Design and development will follow an agile methodology with two-week sprints and regular stakeholder reviews.</p>

    <h2>Budget Considerations</h2>
    <p>The proposed budget covers all aspects of the redesign including design, development, content migration, and quality assurance testing.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

pdf.MetaData.Title = "Website Redesign Proposal";
pdf.MetaData.Author = "Digital Strategy Team";

pdf.SaveAs("proposal-accessible.pdf");

Console.WriteLine("Structured document created with proper heading hierarchy.");

輸出PDF

此PDF保持了標題層次結構和列表結構，便於導航：

注意此範例中的標題層次結構。 文件有一個h1作為主標題，之後是用於主要章節的h2元素，還有小節的h3元素。 這種層次結構對可訪性至關重要。 輔助技術的使用者經常通過在標題之間跳轉來導航文件，因此邏輯結構使他們能快速找到所需的內容。

列表的語義處理使用ul表示無序列表，ol表示有序列表。 每個li元素在PDF中成為標記的列表項目。 輔助技術透過表示列表包含多少項目，然後按順序讀取每個項目來進行宣告。

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones

首席軟體工程師，Agorus Build

查看案例研究

如何為影像新增替代文字以達到螢幕閱讀器的相容性？

影影對可存取性構成了一個基本的挑戰。 視覺內容對於失明或視力低下的使用者來說是無法察覺的。 替代文字，通常稱為alt文字，提供了一個可以替代影像進行公告的文字描述。

從HTML生成PDF時，img元素上的alt屬性會帶到PDF中作為替代文字。

程式碼建立了一份有兩張圖表影像的銷售報告。 每一個alt屬性，描述圖表的資料而不只是其型別。 例如，alt文字具體說明了實際銷售數字和地區比較。 RenderHtmlAsPdfUA()方法將這些描述嵌入為PDF中的替代文字，讓螢幕閱讀器可以傳達查看圖表的使用者所獲得的相同見解。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <title>Sales Performance Report</title>
    <style>
        body { font-family: Arial, sans-serif; padding: 20px; }
        .chart-container { margin: 20px 0; text-align: center; }
        img { max-width: 100%; height: auto; }
        .caption { font-style: italic; color: #666; margin-top: 10px; }
    </style>
</head>
<body>
    <h1>Q3 Sales Performance Report</h1>

    <h2>Regional Sales Comparison</h2>
    <p>The following chart illustrates sales performance across regions for the third quarter.</p>

    <div class='chart-container'>
        <img src='https://example.com/charts/regional-sales-q3.png'
             alt='Bar chart comparing Q3 sales across four regions: Northeast at 2.4 million dollars, Southeast at 1.8 million dollars, Midwest at 2.1 million dollars, and West at 3.2 million dollars. The West region shows the highest performance with a 15 percent increase from Q2.'
             width='600' height='400'>
        <p class='caption'>Figure 1: Regional Sales Comparison Q3 2024</p>
    </div>

    <h2>Monthly Trend Analysis</h2>
    <p>Sales showed consistent growth throughout the quarter with acceleration in September.</p>

    <div class='chart-container'>
        <img src='https://example.com/charts/monthly-trend.png'
             alt='Line graph showing monthly sales from July through September. July sales were 2.1 million dollars, August increased to 2.4 million dollars, and September reached 2.9 million dollars, representing a 38 percent total increase over the quarter.'
             width='600' height='300'>
        <p class='caption'>Figure 2: Monthly Sales Trend Q3 2024</p>
    </div>

    <h2>Key Findings</h2>
    <p>Analysis indicates strong momentum heading into Q4, particularly in the Western region where new product launches drove significant customer acquisition.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

pdf.MetaData.Title = "Q3 Sales Performance Report";
pdf.MetaData.Author = "Sales Analytics Team";

pdf.SaveAs("sales-report-accessible.pdf");

Console.WriteLine("Report created with accessible image descriptions.");

編寫有效的alt文字需要了解影像傳達什麼資訊。 對於圖表而言，alt文字應描述所展示的資料，而非僅僅聲明存在圖表。 說"柱形圖"對使用者沒有任何幫助。 描述"柱形圖比較第三季度在四個地區的銷售額，其中西部領先320萬美元"使視障使用者獲得與視覺使用者觀看圖表相同的見解。

裝飾性影像如果沒有資訊性目的，應有空的alt屬性。 這提醒螢幕閱讀器可以略過圖影：

<img src="decorative-border.png" alt="">
HTML

如何在PDF文件中構建可存取的表格？

表格在可存取性上呈現複雜的考量，因為它們在兩個維度上編碼了資料之間的關係。 可視化的使用者可以通過在行間掃描和下滑到列來理解不同儲存格與其標題的關聯。 依賴輔助技術的使用者需要這種關系通過正確的標記來明確定義。

HTML提供了可存取表格所需的結構元素。 關鍵元素包含用于標題單元格的th、用于資料單元格的td和澄清標題是否適用于行或列的scope屬性。

程式碼建立了一個具有適當可訪性標記的員工目錄表，caption元素提供了一個表格標題，公告在內容之前。 標題用scope="col"表示，說明其應用到列中的所有儲存格。 tbody元素分隔結構部分。 IronPDF的RenderHtmlAsPdfUA()將這些關系保留在PDF結構中，允許螢幕閱讀器將資料單元格與其列標頭關聯。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <title>Employee Directory</title>
    <style>
        body { font-family: Arial, sans-serif; padding: 20px; }
        table { border-collapse: collapse; width: 100%; margin: 20px 0; }
        th, td { border: 1px solid #ccc; padding: 12px; text-align: left; }
        th { background-color: #f0f0f0; font-weight: bold; }
        caption { font-size: 18px; font-weight: bold; margin-bottom: 10px; text-align: left; }
    </style>
</head>
<body>
    <h1>Department Staff Directory</h1>
    <p>Contact information for all department personnel as of January 2024.</p>

    <table>
        <caption>Engineering Department Staff</caption>
        <thead>
            <tr>
                <th scope='col'>Name</th>
                <th scope='col'>Title</th>
                <th scope='col'>Email</th>
                <th scope='col'>Extension</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>Sarah Chen</td>
                <td>Senior Software Engineer</td>
                <td>schen@company.com</td>
                <td>4521</td>
            </tr>
            <tr>
                <td>Marcus Williams</td>
                <td>DevOps Engineer</td>
                <td>mwilliams@company.com</td>
                <td>4522</td>
            </tr>
            <tr>
                <td>Jennifer Park</td>
                <td>QA Lead</td>
                <td>jpark@company.com</td>
                <td>4523</td>
            </tr>
            <tr>
                <td>Robert Gonzalez</td>
                <td>Technical Writer</td>
                <td>rgonzalez@company.com</td>
                <td>4524</td>
            </tr>
        </tbody>
    </table>

    <h2>Contact Guidelines</h2>
    <p>Please use email for non-urgent matters. Phone extensions connect to voicemail outside business hours.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

pdf.MetaData.Title = "Department Staff Directory";

pdf.SaveAs("directory-accessible.pdf");

Console.WriteLine("Directory created with accessible table structure.");

輸出PDF

輸出包含正確結構的表格及標頭關聯：

在th元素上的scope屬性是關鍵。 設置scope="col"表示該標頭應用於該列中的所有單元格。 對於每行的第一個單元格作為行標頭的表格，您可以使用scope="row"。 具有行和列標頭的複雜表格則需要同時使用這兩個屬性。

caption元素提供了一個表格標題，公告在讀取表格內容之前。 這為使用者提供了他們即將聽到的資料的上下文。

對於帶有合併儲存格或不規則結構的表格，附加屬性如標頭和id可以明確將資料儲存格連接到其相應的標頭。 然而，為了可存取性，簡單一致的行和列結構是更可取的。

如何為文件可存取性增加書籤和導航？

書籤提供導引地標，有助於所有使用者在冗長文件中移動，但對可訪性尤為重要。 無法目視掃描頁面的使用者依賴書籤來找到感興趣的段落。這些結構化大綱允許直接跳轉到特定內容。

IronPDF支持以程式碼方式建立分層書籤結構。

程式碼呈現了一份多章節的員工手冊，然後通過使用Bookmarks集合程式碼方式新增書籤層次結構。 頂層書籤透過AddBookMarkAtEnd()帶有頁面索引指向章節起始頁。 小節的子書籤通過父級的Children屬性新增，建立出巢狀的導航樹。 頁面索引參數是零基數，因此第0頁是第一頁。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <title>Employee Handbook</title>
    <style>
        body { font-family: Georgia, serif; line-height: 1.8; padding: 40px; }
        h1 { page-break-before: always; }
        h1:first-of-type { page-break-before: avoid; }
        h2 { margin-top: 30px; }
    </style>
</head>
<body>
    <h1>Employee Handbook</h1>
    <p>Welcome to our organization. This handbook contains policies and procedures for all employees.</p>

    <h1>Chapter 1: Employment Policies</h1>
    <h2>Equal Opportunity</h2>
    <p>Our organization is committed to providing equal employment opportunities to all applicants and employees.</p>

    <h2>At-Will Employment</h2>
    <p>Employment with the organization is at-will unless otherwise specified in a written agreement.</p>

    <h1>Chapter 2: Compensation and Benefits</h1>
    <h2>Pay Periods</h2>
    <p>Employees are paid on a bi-weekly basis, with pay dates falling on alternating Fridays.</p>

    <h2>Health Insurance</h2>
    <p>Full-time employees are eligible for health insurance coverage beginning the first of the month following hire date.</p>

    <h2>Retirement Plans</h2>
    <p>The organization offers a 401(k) plan with employer matching contributions up to four percent of salary.</p>

    <h1>Chapter 3: Time Off Policies</h1>
    <h2>Vacation</h2>
    <p>Employees accrue vacation time based on length of service, starting at two weeks annually.</p>

    <h2>Sick Leave</h2>
    <p>Employees receive five days of paid sick leave per calendar year.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

// Add top-level bookmarks for main sections
var introBookmark = pdf.Bookmarks.AddBookMarkAtEnd("Introduction", 0);

var chapter1Bookmark = pdf.Bookmarks.AddBookMarkAtEnd("Chapter 1: Employment Policies", 1);
chapter1Bookmark.Children.AddBookMarkAtEnd("Equal Opportunity", 1);
chapter1Bookmark.Children.AddBookMarkAtEnd("At-Will Employment", 1);

var chapter2Bookmark = pdf.Bookmarks.AddBookMarkAtEnd("Chapter 2: Compensation and Benefits", 2);
chapter2Bookmark.Children.AddBookMarkAtEnd("Pay Periods", 2);
chapter2Bookmark.Children.AddBookMarkAtEnd("Health Insurance", 2);
chapter2Bookmark.Children.AddBookMarkAtEnd("Retirement Plans", 2);

var chapter3Bookmark = pdf.Bookmarks.AddBookMarkAtEnd("Chapter 3: Time Off Policies", 3);
chapter3Bookmark.Children.AddBookMarkAtEnd("Vacation", 3);
chapter3Bookmark.Children.AddBookMarkAtEnd("Sick Leave", 3);

pdf.MetaData.Title = "Employee Handbook";
pdf.MetaData.Author = "Human Resources";

pdf.SaveAs("handbook-with-bookmarks.pdf");

Console.WriteLine("Handbook created with navigational bookmarks.");

輸出PDF

生成的PDF包含一個可導航的書籤面板，可快速存取段落：

在AddBookMarkAtEnd中的頁面索引參數使用零基數索引，其中第0頁是文件的第一頁。 透過Children屬性建立的巢狀書籤建立了反映文件結構的層次體系。

對於具有正確標題結構的HTML文件，IronPDF可以自動生成包含連結導航的目錄。

程式碼透過設置TableOfContentsTypes.WithPageNumbers啟用自動目錄生成功能。 HTML內包含一個佔位符id="ironpdf-toc"，用於插入生成的目錄。 IronPDF掃描標題元素（h2等），構建帶有頁碼的層次目錄，並在佔位符位置插入。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Enable automatic table of contents generation
renderer.RenderingOptions.TableOfContents = TableOfContentsTypes.WithPageNumbers;

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head><title>Technical Manual</title></head>
<body>
    <div id='ironpdf-toc'></div>

    <h1>System Administration Guide</h1>
    <p>Comprehensive guide to system configuration and maintenance.</p>

    <h2>Installation</h2>
    <p>Step-by-step installation procedures for all supported platforms.</p>

    <h2>Configuration</h2>
    <p>Detailed configuration options and recommended settings.</p>

    <h2>Troubleshooting</h2>
    <p>Common issues and their resolutions.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

pdf.MetaData.Title = "System Administration Guide";

pdf.SaveAs("manual-with-toc.pdf");

具有id="ironpdf-toc"的div標記生成的目錄將出現的位置。 IronPDF從標題元素建立目錄，建立可點擊的鏈結跳轉到每個段落。

如何使用正確標簽建立可存取的PDF表單?

互動式表單需要特別關注可訪性。 每個輸入欄位必須有一個程式上連接的標籤，以便可以通告預期的輸入內容。 僅有視覺標籤是不夠的，因為它們缺乏輔助技術正確解讀表單所需的底層連接。

IronPDF將HTML表單元素渲染為互動式PDF表單欄位。 適當的HTML表單標記轉化為可存取的PDF表單。

程式碼通過設置RenderingOptions.CreatePdfFormsFromHtml = true啟用表單欄位建立。 HTML表單使用適當的可存取模式：每個輸入都有一個唯一的fieldset中集中，複選框具有相關的標籤。 RenderHtmlAsPdfUA()方法將這些元素轉換為帶有標籤組合的互動式PDF表單欄位，以供螢幕閱讀器聯想。

using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Enable form field creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <title>Contact Request Form</title>
    <style>
        body { font-family: Arial, sans-serif; padding: 30px; max-width: 600px; }
        .form-group { margin-bottom: 20px; }
        label { display: block; margin-bottom: 5px; font-weight: bold; }
        input[type='text'], input[type='email'], textarea {
            width: 100%; padding: 10px; border: 1px solid #ccc; border-radius: 4px;
        }
        textarea { height: 120px; resize: vertical; }
        .checkbox-group { margin: 15px 0; }
        .checkbox-group label { display: inline; font-weight: normal; margin-left: 8px; }
        fieldset { border: 1px solid #ddd; padding: 15px; margin-bottom: 20px; }
        legend { font-weight: bold; padding: 0 10px; }
    </style>
</head>
<body>
    <h1>Contact Request Form</h1>
    <p>Please complete all required fields marked with an asterisk.</p>

    <form>
        <div class='form-group'>
            <label for='fullname'>Full Name *</label>
            <input type='text' id='fullname' name='fullname' required>
        </div>

        <div class='form-group'>
            <label for='email'>Email Address *</label>
            <input type='email' id='email' name='email' required>
        </div>

        <div class='form-group'>
            <label for='phone'>Phone Number</label>
            <input type='text' id='phone' name='phone'>
        </div>

        <fieldset>
            <legend>Preferred Contact Method</legend>
            <div class='checkbox-group'>
                <input type='radio' id='contact-email' name='contact-method' value='email'>
                <label for='contact-email'>Email</label>
            </div>
            <div class='checkbox-group'>
                <input type='radio' id='contact-phone' name='contact-method' value='phone'>
                <label for='contact-phone'>Phone</label>
            </div>
        </fieldset>

        <div class='form-group'>
            <label for='message'>Message *</label>
            <textarea id='message' name='message' required></textarea>
        </div>

        <div class='checkbox-group'>
            <input type='checkbox' id='newsletter' name='newsletter'>
            <label for='newsletter'>Subscribe to our newsletter</label>
        </div>
    </form>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);

pdf.MetaData.Title = "Contact Request Form";

pdf.SaveAs("contact-form-accessible.pdf");

Console.WriteLine("Accessible form created with proper field labels.");

輸出PDF

生成的PDF包含與正確標籤組合的互動式表單欄位：

此表單範例中出現了幾個可訪性模式。 每個輸入都有唯一的id屬性，與其標籤的for屬性匹配。 這個連接使當使用者定位到該欄位時能公告"全名，編輯文字"。 單選按鈕在配有説明該組用途的傳奇的欄位集中組合。 複選框的標籤在其輸入元素後，遵循標準表單慣例。

IronPDF必須啟用CreatePdfFormsFromHtml渲染選項，以便建立互動式表單欄位，而不是表單的靜態表示。

如何生成後驗證PDF/UA合規性？

僅建立具有可訪性功能的PDF只是過程的一部分。 驗證確認生成的文件實際符合PDF/UA標準的技術要求。 為了這個目的有若干工具，其中veraPDF是最廣泛認可的開源驗證器。

雖然IronPDF不包含內建驗證，但您可以使用外部工具將驗證整合到您的工作流中。 veraPDF驗證器可以作為一個命令行程式從C#程式碼中調用。

該程式碼演示了完整的驗證流程。 首先，使用RenderHtmlAsPdfUA()生成一個測試PDF，同時設置了元資料。 接著透過C#調用veraPDF，使用--flavour ua1旗幟運行進程。 輸出被捕獲，退出程式碼決定文件是否通過驗證。

using IronPdf;
using System;
using System.Diagnostics;

// Create the accessible PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();

string htmlContent = @"
<!DOCTYPE html>
<html lang='en'>
<head><title>Test Document</title></head>
<body>
    <h1>Validation Test</h1>
    <p>This document will be validated for PDF/UA compliance.</p>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(htmlContent);
pdf.MetaData.Title = "Validation Test Document";

string outputPath = "test-document.pdf";
pdf.SaveAs(outputPath);

Console.WriteLine($"PDF created at: {outputPath}");
Console.WriteLine("Run veraPDF validation with:");
Console.WriteLine($"  verapdf --flavour ua1 {outputPath}");

// Validate using veraPDF
string verapdfPath = "verapdf";
ProcessStartInfo startInfo = new ProcessStartInfo
{
    FileName = verapdfPath,
    Arguments = $"--flavour ua1 \"{outputPath}\"",
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    UseShellExecute = false,
    CreateNoWindow = true
};

using (Process process = Process.Start(startInfo))
{
    string output = process.StandardOutput.ReadToEnd();
    process.WaitForExit();

    // veraPDF returns 0 for valid documents
    bool isValid = process.ExitCode == 0;

    Console.WriteLine(isValid ? "Document passes PDF/UA validation." : "Document has validation issues.");
    Console.WriteLine(output);
}

Adobe Acrobat Pro也包含可訪性檢查功能。 Acrobat Pro中的可訪性檢查器執行全面測試，包括閱讀順序驗驗證，替代文字驗證和表單欄位可訪性。 雖然不是免費的，但Acrobat Pro通常在企業環境中可用，並提供有關可訪性問題的詳細報告。

對於自動測試管道，PDF/UA基金會的PAC（PDF可訪性檢查器）工具提供另一個驗證選項。 PAC 提供圖形介面和命令行能力，使其適合整合到持續整合工作流中。

在企業應用程式中維持可存取的PDF的最佳實踐？

一旦您掌握了技術，構建個體可存取文件就會變得簡單。 在整個企業範圍內維護可訪性需要系統的方法和組織紀律。

模板標準化減少了變異性並確保了一致性。 建立經審核的HTML模板庫，具有語義結構、可訪表單模式和一致的樣式，為開發者提供了一個生產符合標準輸出的基礎。

該程式碼演示了一種企業報告生成模式。 它初始化了一個HttpUtility.HtmlEncode()從模板變數構建HTML報告，進行安全內容插入。 報告HTML包括一致的樣式和語義結構。 在使用RenderHtmlAsPdfUA()渲染後，標準元資料屬性（標題、作者、建立者和日期）會在保存前進行配置。 這種模式可以被包裝成一個可重用的服務，以強制在所有生成的文件中執行可訪性合規性。

using IronPdf;
using System;
using System.Web;

ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string title = "Quarterly Report";
string author = "Finance Team";
string content = "<p>Financial performance overview for Q4 2024.</p>";

// Build report HTML from template
string reportHtml = $@"
<!DOCTYPE html>
<html lang='en'>
<head>
    <meta charset='UTF-8'>
    <title>{HttpUtility.HtmlEncode(title)}</title>
    <style>
        body {{
            font-family: 'Segoe UI', Arial, sans-serif;
            line-height: 1.6;
            max-width: 800px;
            margin: 0 auto;
            padding: 40px;
            color: #333;
        }}
        h1 {{ font-size: 28px; color: #1a1a1a; border-bottom: 2px solid #0066cc; padding-bottom: 10px; }}
        h2 {{ font-size: 22px; color: #333; margin-top: 30px; }}
        p {{ margin-bottom: 15px; }}
        table {{ border-collapse: collapse; width: 100%; margin: 20px 0; }}
        th, td {{ border: 1px solid #ddd; padding: 12px; text-align: left; }}
        th {{ background-color: #f5f5f5; }}
    </style>
</head>
<body>
    <h1>{HttpUtility.HtmlEncode(title)}</h1>
    {content}
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdfUA(reportHtml);

// Configure standard metadata
pdf.MetaData.Title = title;
pdf.MetaData.Author = author;
pdf.MetaData.Creator = "Enterprise Document System";
pdf.MetaData.CreationDate = DateTime.Now;
pdf.MetaData.ModifiedDate = DateTime.Now;

pdf.SaveAs("quarterly-report-accessible.pdf");

自動化測試應該是您持續整合管道的一部分。任何生成PDF的過程都應包括驗證步驟，當可訪性要求未得到滿足時，使生成失敗。 這防止了不可訪文件進入生產環境。

員工培訓與技術實施同樣重要。 內容作者需要理解為何可訪性重要，以及他們的選擇如何影響最終輸出。 教導撰寫者正確使用標題層次、提供有意義的影像描述和良好構建表格將產生更好的原材料，轉換為符合標準的PDF。

模板的版本控制和定期可訪性審計有助於隨著時間的推移維持合規性。隨著業務需求演變和模板修改，定期評審確保變更未無意間引入可訪性障礙。

記錄您可訪性的方式創造了一種機構知識，可以隨著員工流動而保留下來。 記錄您遵循的標準、使用的驗證工具以及針對識別出問題的補救程式，幫助在整個組織內維持一致的實踐。

可訪性不是一次性成就，而是持續的承諾。 標準演變、輔助技術改進、使用者需求改變。 將可訪性嵌入到標準工作流程中的組織，比起將其作為事後考慮，更有可能符合當前的要求和未來的期望。

本指南中介紹的技術為使用IronPDF建立符合第508條標準的PDF提供了堅實的基礎。 通過結合適當的HTML結構、相應的元資料、導航輔助工具和驗證測試，.NET開發者可以製作符合法律要求，並真正服務於依賴於可訪內容的使用者的文件。

結論

IronPDF簡化了PDF可訪性標準的複雜性，讓.NET開發者能專注於內容，而程式庫則處理底層的PDF/UA結構要求。 本教程涵蓋了將現有PDF轉換為PDF/UA格式，直接渲染HTML到可存取PDF，設置文件元資料和語言規範以提高螢幕閱讀器的相容性，從語義HTML建立標記的文件結構，構建可存取的表單和使用書籤進行導航，並使用如veraPDF等外部工具驗證合規性。

當可存取性是整體文件生命週期的一部分時，這些模式自然與PDF/A存檔合規性配合，以實現長期保存和批處理，以在政府或醫療系統中大規模生成可存取的文件。

準備好開始構建了嗎？ 下載 IronPDF並試用免費試用版。 同一個程式庫可以處理從單一可存取文件生成到企業級PDF/UA合規管道的所有需求。 如果您對可存取性實施或Section 508要求有疑問，請聯繫我們的工程支援團隊。

Frequently Asked Questions

什麼是PDF的Section 508合規性？

Section 508合規性確保電子和資訊技術（如PDF）對於殘障人士是可存取的。IronPDF幫助建立符合這些標準的PDF，允許您新增替代文字，構建可存取的表格等。

我如何使用IronPDF將現有PDF轉換為PDF/UA？

IronPDF提供功能將現有PDF轉換為PDF/UA，確保它們符合無障礙標準。這包括新增必要的元資料和結構元素使內容可存取。

IronPDF可以幫助渲染可存取的HTML嗎？

是的，IronPDF可以渲染符合PDF/UA標準的可存取HTML內容，讓從網頁內容建立可存取文件變得更容易。

如何使用IronPDF將替代文字新增到PDF中的圖像？

IronPDF允許您在PDF中向圖像新增替代文字，這對於無障礙性至關重要。此功能確保圖像被描述給依賴螢幕閱讀器的使用者。

IronPDF為構建可存取的表格和表單提供了哪些功能？

IronPDF提供工具建立結構化的表格和表單，確保資料和輸入字段對所有使用者是可導航和可理解的。

如何使用IronPDF驗證我的PDF是否符合政府要求？

IronPDF包含驗證工具以檢查您的PDF是否符合Section 508和PDF/UA的要求，幫助您確保您的文件符合必要的無障礙標準。

是否可以用IronPDF自動建立可存取的PDF？

可以，IronPDF可以整合到自動化工作流程中以一致地生成可存取的PDF，簡化達到合規標準的過程。

哪些編程語言可與IronPDF相容以建立可存取的PDF？

IronPDF設計為與C#一起工作，允許開發者直接在.NET框架內建立可存取的PDF。

是否有教學資源可以學習如何使用IronPDF？

是的，IronPDF提供了全面的教程和文件，指導您如何建立可存取的PDF並有效地利用所有功能。

IronPDF可以協助多語言PDF無障礙嗎？

IronPDF支持通過處理Unicode文字和語言建立多語言可存取的PDF，確保不同語言文件的可訪性。

Curtis Chau
Curtis Chau
Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...
Read More

準備開始了嗎？

Nuget Downloads 20,389,208版本：2026.7剛剛發布

免費 NuGet 下載
總下載次數：20,389,208
立即獲取您的免費30天試用密鑰。
不需要信用卡或建立賬戶

免費試用IronPDF

5分鐘內設定完成

C# PDF DLL

下載DLL

立即下載

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置，位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器，右鍵點選參考。選擇瀏覽，"IronPdf.dll"
C# 用於PDF的NuGet程式庫

使用NuGet安裝

                  Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器，右鍵點選參考，管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝

授權從$999起

有問題嗎？聯絡我們的開發團隊。

Key in blue circle

立即免費取得 30 天試用金鑰。

bullet_checked無需信用卡或建立帳號
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費現場演示
Booking Badge related to IronPDF Product Demo

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密。
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰。
無需信用卡或帳戶建立