如何用 C# 生成灰度 PDF；

Updated: 2026年9月5日

IronPDF允许您通过在true来呈现灰度PDF，将彩色内容转换为灰度阴影，以实现经济高效的打印和提高可读性。

快速入门：使用IronPDF将彩色 PDF 转换为灰度 PDF

using IronPDF 将彩色 PDF 转换为灰度 PDF，只需几行代码。在GrayScale属性以将网页或HTML内容呈现为灰度PDF。本指南将向您展示如何生成灰度文档，以实现一致的浏览效果。

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2复制并运行这段代码。

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

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

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronPDF

最小工作流程（5 个步骤）

下载用于渲染灰度 PDF 的 IronPDF 库。
实例化 ChromePdfRenderer 类
将 RenderingOptions 的 GrayScale 属性设置为 true
从 URL、HTML 字符串或文件访问并渲染 PDF 文档
将灰度 PDF 文档导出到所需位置

如何生成灰度 PDF？

要生成灰度PDF，请将true。该功能是 IronPDF 全面渲染选项的一部分，可让您精细控制 PDF 输出。

在提供的代码片段中，灰度功能在实例化ChromePdfRenderer后启用。然后使用RenderUrlAsPdf方法渲染网页。代码还只能提取渲染 PDF 的第一页，并将其保存在本地。如果您是 IronPDF 的新用户，请查看我们的快速入门指南，了解基础知识。

为什么将`GrayScale`设置为True会转换颜色？

灰度 PDF 是指所有颜色和色调都用灰色来表示，而不是用全彩光谱来表示的文档。当您启用GrayScale选项时，IronPDF的Chrome 渲染引擎会自动将所有RGB颜色值转换为对应的灰度值，使用行业标准的亮度计算。这将确保在删除所有颜色信息的同时，保留原始文档的视觉层次和对比度。

何时应使用灰度 PDF？

IronPDF 以灰度而非彩色渲染 PDF 文档。以灰度打印PDF文件对于大批量打印来说更具成本效益。当原始颜色过于明亮或鲜艳时，采用灰度渲染可提高可读性。灰度 PDF 增强了跨设备、软件和平台的兼容性，确保了一致的查看和打印体验。

灰度 PDF 的常见用例包括

商业报告：灰度的财务文件通常看起来更专业
法律文件：法院文件和法律简报通常需要灰度格式化
学术论文：研究论文和学位论文通常以灰度打印
大批量打印：灰度降低了打印数百页时的成本
存档文件：长期存储和IronPDF/A 合规性的理想选择

转换为灰度时文本会发生什么变化？

灰度功能的当前实现将渲染的PDF文档中的文本转换为图像，导致ExtractAllImages方法不输出任何文本。

目前，此功能仅在渲染PDF文件时可用。未来的更新可能包括将现有 PDF 文档转换为灰度文档的功能。有关文本提取工作的更多信息，请参阅我们的 Extract Text & Images 指南。

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");

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");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Set GrayScale to true
renderer.RenderingOptions.GrayScale = True

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://ironsoftware.com/")
pdf.CopyPage(0).SaveAs("test.pdf")

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Set GrayScale to true
renderer.RenderingOptions.GrayScale = True

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://ironsoftware.com/")
pdf.CopyPage(0).SaveAs("test.pdf")

高级灰度 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");

Imports IronPdf

' Create a renderer with grayscale enabled
Dim renderer As New ChromePdfRenderer() With {
    .RenderingOptions = New ChromePdfRenderOptions() With {
        .GrayScale = True,
        .MarginTop = 50,
        .MarginBottom = 50,
        .MarginLeft = 20,
        .MarginRight = 20
    }
}

' Render an HTML file to grayscale PDF
Dim pdf = renderer.RenderHtmlFileAsPdf("C:\Reports\MonthlyReport.html")
pdf.SaveAs("C:\Reports\MonthlyReport_Grayscale.pdf")

Imports IronPdf

' Create a renderer with grayscale enabled
Dim renderer As New ChromePdfRenderer() With {
    .RenderingOptions = New ChromePdfRenderOptions() With {
        .GrayScale = True,
        .MarginTop = 50,
        .MarginBottom = 50,
        .MarginLeft = 20,
        .MarginRight = 20
    }
}

' Render an HTML file to grayscale PDF
Dim pdf = renderer.RenderHtmlFileAsPdf("C:\Reports\MonthlyReport.html")
pdf.SaveAs("C:\Reports\MonthlyReport_Grayscale.pdf")

从 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");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.GrayScale = True

' HTML content with inline CSS
Dim htmlContent As String = "
    <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>"

Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("invoice_grayscale.pdf")

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.GrayScale = True

' HTML content with inline CSS
Dim htmlContent As String = "
    <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>"

Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("invoice_grayscale.pdf")

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

性能考虑

生成灰度 PDF 时，请考虑以下性能因素：

1.文件大小：灰度 PDF 比彩色版本小，非常适合电子邮件附件和网络下载 2.呈现速度：灰度转换对呈现时间的影响微乎其微 3.内存使用：灰度呈现比全彩呈现占用更少内存，有利于大型文档的处理

为了在生成多个灰度 PDF 时获得更好的性能，请使用 async 和多线程技术。

与 IronPDF 其他功能的集成

将灰度 PDF 与 IronPDF 的其他功能相结合，实现全面的文档处理：

页眉和页脚：使用我们的页眉和页脚指南为您的灰度文档添加专业的页眉和页脚
页码：按照我们的页码教程在您的灰度 PDF 中加入页码。
水印：在灰度 PDF 上应用水印，以实现品牌或安全性
PDF 压缩：通过将灰度呈现与 PDF 压缩相结合，进一步缩小文件大小

灰度 PDF 生成的最佳实践

1.测试色彩对比度：在转换之前确保元素之间有足够的对比度 2.使用语义 HTML：结构良好的 HTML 可产生更好的灰度转换效果 3.考虑可访问性：灰度 PDF 可提高某些视觉障碍人士的可读性 4.生产前预览：始终在生成大批量灰度输出之前进行预览

ABCpdf 常见问题和解决方案

如果遇到灰度 PDF 生成问题：

文字看起来模糊：在渲染选项中使用适当的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 还能提高可读性，确保不同设备和平台之间更好的兼容性，并提供一致的查看体验。

我能否将特定页面转换为灰度，而将其他页面保留为彩色？

using IronPDF，您可以灰度渲染文档，然后使用 CopyPage 等方法提取特定页面。启用 GrayScale 属性后，整个文档都将以灰度渲染，您还可以结合不同的渲染通道来创建彩色和灰度混合文档。

哪些类型的内容可以转换为灰度 PDF？

IronPDF 可将各种内容类型转换为灰度 PDF，包括通过 RenderUrlAsPdf 转换网页、通过 RenderHtmlAsPdf 转换 HTML 字符串以及使用 RenderHtmlFileAsPdf 转换 HTML 文件。所有内容类型都支持相同的灰度渲染选项，以获得一致的结果。

How does the IronPDF Chrome rendering engine process grayscale PDFs?

IronPDF's Chrome rendering engine converts colors in a document to grayscale using industry-standard luminance calculations, ensuring the visual hierarchy and contrast of the original content are preserved while stripping away color information.

What are some performance considerations when generating grayscale PDFs?

Grayscale PDFs have smaller file sizes, use less memory, and incur minimal overhead in rendering time compared to full-color PDFs. It is recommended to use async and multithreading techniques when generating multiple grayscale PDFs for better performance.

Can I combine grayscale rendering with other IronPDF features?

Yes, you can combine grayscale rendering with features such as headers and footers, page numbers, watermarks, and PDF compression to enhance document processing capabilities.

What best practices should I follow for generating grayscale PDFs?

Ensure sufficient color contrast in your source documents, use well-structured HTML, consider accessibility for visually impaired readers, and preview grayscale output before large-scale production to achieve optimal results.

How do I troubleshoot common issues with grayscale PDF generation using IronPDF?

For text appearing blurry, adjust DPI settings. If images look washed out, modify the image contrast beforehand. For performance issues, consider implementing caching. Check IronPDF's troubleshooting guide for more detailed solutions.