1. IronPDF
  2. 操作指南
  3. 灰度
如何在 C# 中生成灰度 PDF 文件

如何在 C# 中產生灰階 PDF

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF可讓您透過將 GrayScale 屬性設為 true 來以灰階渲染 PDF，將 RenderingOptions 中的彩色內容轉換為灰度，從而實現經濟高效的列印和提高可讀性。

快速入門：使用IronPDF將彩色 PDF 轉換為灰階 PDF

使用IronPDF ，只需幾行程式碼即可將彩色 PDF 轉換為灰階 PDF。 在 RenderingOptions 中設定 GrayScale 屬性，以將網頁或 HTML 內容渲染為灰階 PDF。 本指南將向您展示如何產生灰階文件以實現一致的檢視效果。

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

    PM > Install-Package IronPdf

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

    var renderer = new IronPdf.ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("grayscale.pdf");

  3. 部署到您的生產環境進行測試

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

    arrow pointer

最簡工作流程(5個步驟)

  1. 下載用於渲染灰階PDF的IronPDF庫
  2. 實例化**`ChromePdfRenderer`**類
  3. 將**`RenderingOptions`**的**`GrayScale`**屬性設為 true
  4. 透過 URL、HTML 字串或文件存取和渲染 PDF 文檔
  5. 將灰階 PDF 文件匯出到所需位置


如何生成灰階PDF？

若要產生灰階 PDF，請將 GrayScale 屬性設為 RenderingOptions。 此功能是 IronPDF 全面渲染選項的一部分，可讓您對 PDF 輸出進行精細控制。

在提供的程式碼片段中，實例化 ChromePdfRenderer 後啟用了灰階功能。 然後它使用 RenderUrlAsPdf 方法渲染網頁。 程式碼還會提取渲染後的 PDF 的第一頁並將其儲存到本機。 如果您是IronPDF的新手，請查看我們的快速入門指南，以了解基本操作。

為什麼將灰階設定為真會轉換顏色？

灰階 PDF 是一種文檔，其中所有顏色和色調都使用灰色陰影而不是完整的顏色光譜來表示。 啟用灰階選項後，IronPDF 的Chrome 渲染引擎會自動使用業界標準的亮度計算將所有 RGB 色彩值轉換為對應的灰階值。 這樣可以確保在去除所有顏色資訊的同時，保留原始文件的視覺層次結構和對比。

何時應該使用灰階PDF？

IronPDF以灰階而非彩色渲染 PDF 文件。 對於大量列印來說，以灰階模式列印 PDF 文件是一種經濟高效的方法。 當原始顏色過於明亮或鮮豔時，以灰階渲染可以提高可讀性。 灰階 PDF 提高了跨裝置、軟體和平台的相容性，確保了一致的檢視和列印體驗。

灰階 PDF 的常見用途包括： -商業報告：財務文件以灰階顯示通常顯得更專業。 -法律文件：法庭文件和法律摘要通常需要灰階格式。 學術論文：研究論文和學位論文通常以灰階列印。 -大量列印：灰階列印可降低數百頁列印成本 -檔案文件：非常適合長期儲存並符合 PDF/A 標準

文字轉換為灰階影像時會發生什麼變化？

目前灰階功能的實作會將渲染的 PDF 文件中的文字轉換為影像，導致 ExtractAllImages 方法不輸出任何文字。

目前，此功能僅在渲染 PDF 時可用。 未來的更新可能會包括將現有 ​​PDF 文件轉換為灰階文件的功能。 有關文字提取的更多信息，請參閱我們的文字和圖像提取指南。

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-grayscale.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set GrayScale to true
renderer.RenderingOptions.GrayScale = true;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://ironsoftware.com/");
pdf.CopyPage(0).SaveAs("test.pdf");
$vbLabelText   $csharpLabel

進階灰階 PDF 產生範例

將HTML檔案轉換為灰階PDF

處理本機 HTML 檔案時，您可以將其轉換為灰階 PDF。 當您有預先設計好的範本或需要以無顏色方式渲染的報表時，此功能非常有用。 了解更多關於將HTML檔案轉換為PDF的資訊。

using IronPdf;

// Create a renderer with grayscale enabled
var renderer = new ChromePdfRenderer()
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        GrayScale = true,
        MarginTop = 50,
        MarginBottom = 50,
        MarginLeft = 20,
        MarginRight = 20
    }
};

// Render an HTML file to grayscale PDF
var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Reports\MonthlyReport.html");
pdf.SaveAs(@"C:\Reports\MonthlyReport_Grayscale.pdf");
using IronPdf;

// Create a renderer with grayscale enabled
var renderer = new ChromePdfRenderer()
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        GrayScale = true,
        MarginTop = 50,
        MarginBottom = 50,
        MarginLeft = 20,
        MarginRight = 20
    }
};

// Render an HTML file to grayscale PDF
var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Reports\MonthlyReport.html");
pdf.SaveAs(@"C:\Reports\MonthlyReport_Grayscale.pdf");
$vbLabelText   $csharpLabel

從 HTML 字串建立灰階 PDF

對於動態內容生成，直接將 HTML 字串轉換為灰階 PDF。 這種方法非常適合產生發票、收據或任何以程式設計方式建立內容的文件。 更多詳情，請造訪我們的HTML 字串轉 PDF指南。

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;

// HTML content with inline CSS
string htmlContent = @"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; }
            .header { background-color: #4CAF50; color: white; padding: 20px; }
            .content { padding: 20px; }
            .highlight { background-color: #ffeb3b; padding: 5px; }
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #12345</h1>
        </div>
        <div class='content'>
            <p>This colorful invoice will be rendered in grayscale.</p>
            <p class='highlight'>Highlighted sections maintain contrast in grayscale.</p>
        </div>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice_grayscale.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;

// HTML content with inline CSS
string htmlContent = @"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; }
            .header { background-color: #4CAF50; color: white; padding: 20px; }
            .content { padding: 20px; }
            .highlight { background-color: #ffeb3b; padding: 5px; }
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #12345</h1>
        </div>
        <div class='content'>
            <p>This colorful invoice will be rendered in grayscale.</p>
            <p class='highlight'>Highlighted sections maintain contrast in grayscale.</p>
        </div>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice_grayscale.pdf");
$vbLabelText   $csharpLabel

性能考量

產生灰階 PDF 時，請考慮以下效能因素：

1.檔案大小：灰階PDF檔案比彩色版本小，非常適合作為電子郵件附件和網頁下載。 2.渲染速度：灰階轉換對渲染時間的開銷極小 3.內存使用：灰階渲染比全彩渲染佔用更少的內存，這有利於處理大型文件。

為了在產生多個灰階 PDF 時獲得更好的效能，請使用非同步和多執行緒技術。

與其他IronPDF功能的集成

將灰階 PDF 與IronPDF 的其他功能結合使用，可實現全面的文件處理：

-頁首和頁尾：使用我們的頁首和頁尾指南，為您的灰階文件新增專業的頁首和頁尾。 -頁碼：按照我們的頁碼教程，在您的灰階 PDF 檔案中新增頁碼。 -浮水印：為灰階 PDF 新增浮水印，用於品牌識別或安全保護。

  • PDF壓縮：透過將灰階渲染與PDF壓縮相結合，進一步減小檔案大小

灰階 PDF 產生的最佳實踐

1.測試顏色對比：轉換前確保元素之間有足夠的對比。 2.使用語意化的 HTML ：結構良好的 HTML 可以產生更好的灰階轉換效果。 3.考慮可訪問性：灰階 PDF 可以提高某些視力障礙人士的閱讀體驗。 4.生產前預覽：在產生大量影像之前，請務必預覽灰階輸出。

常見問題排除

如果您在產生灰階 PDF 時遇到問題：

1.文字模糊：請在渲染選項中使用適當的 DPI 設定 2.圖片看起來發白：轉換前請調整來源影像對比。 3.效能問題：對頻繁產生的灰階PDF檔案實現緩存

如需詳細故障排除信息，請訪問我們的綜合故障排除指南。

準備好要看看你還能做什麼了嗎？ 請造訪我們的教學頁面：轉換 PDF 文件

常見問題解答

如何在 C# 中將彩色 PDF 轉換為灰階？

要使用 IronPDF 將彩色 PDF 轉換為灰階，請實體化一個 ChromePdfRenderer 物件，並將 RenderingOptions 中的 GrayScale 屬性設定為 true。然後使用 RenderUrlAsPdf、RenderHtmlAsPdf 或 RenderHtmlFileAsPdf 等方法來產生您的灰階 PDF 文件。

RenderingOptions 中的 GrayScale 屬性有何作用？

IronPDF 的 RenderingOptions 中的 GrayScale 屬性可將 PDF 中的所有顏色轉換為灰色。當設定為 true 時，IronPDF 的 Chrome 渲染引擎會自動計算 RGB 顏色的亮度值，並將其轉換為等效的灰階顏色，同時保留視覺層次和對比。

為何要使用灰階 PDF 而非彩色 PDF？

IronPDF 的灰度渲染功能非常適合用於具有成本效益的列印，尤其適合大批量作業。當原始顏色太亮時，灰階 PDF 還能增強可讀性，確保在不同設備和平台上有更好的相容性，並提供一致的檢視體驗。

我可以將特定頁面轉換為灰階，而將其他頁面保留為彩色嗎？

使用 IronPDF，您可以灰度渲染文檔，然後使用 CopyPage 等方法提取特定頁面。當 GrayScale 屬性啟用時，整個文件會以灰階呈現，但您可以結合不同的呈現通道來建立彩色與灰階混合的文件。

哪些類型的內容可以轉換為灰階 PDF？

IronPDF 可以將各種內容類型轉換為灰階 PDF，包括透過 RenderUrlAsPdf 轉換的網頁、透過 RenderHtmlAsPdf 轉換的 HTML 字串，以及使用 RenderHtmlFileAsPdf 轉換的 HTML 檔案。所有內容類型都支援相同的 GrayScale 渲染選項，以獲得一致的結果。

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  立即與工程團隊聊天
軟體工程師
和所有优秀的工程师一样，Hairil 是個努力学习者。他正在细化自己的 C# 、Python 和 Java 知识，将这些知识應用于 Iron Software 各個团队成员以增加价值。Hairil 自马来西亚 Universiti Teknologi MARA 加入 Iron Software 团队，并以化学与工艺工程学士学位毕业。
準備好開始了嗎？
Nuget 下載 17,803,474 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎？

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