如何在 C# 中產生灰階 PDF；

IronPDF 可讓您透過在 RenderingOptions 中設定 GrayScale 屬性為 true 來以灰階呈現 PDF，將彩色內容轉換為深淺不一的灰色，以符合成本效益的方式列印，並提高可讀性。

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

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

如何產生灰階 PDF？ 若要產生灰階 PDF，請將 `RenderingOptions` 的 `GrayScale` 屬性設定為 `true`。 此功能是 IronPdf 全面的 [ 渲染選項](https://ironpdf.com/how-to/rendering-options/)的一部分，可讓您精細控制 PDF 輸出。 在提供的程式碼片段中，灰階功能是在實體化 `ChromePdfRenderer` 之後啟用的。 然後使用 `RenderUrlAsPdf` 方法渲染網頁。 程式碼也只能擷取呈現 PDF 的第一頁，並將其儲存在本機。 如果您是 IronPdf 的新用戶，請查看我們的 [Quickstart Guide](https://ironpdf.com/get-started/quickstart/) 以瞭解基本知識。

為何設定 GrayScale 為 True 會轉換顏色？ 灰階 PDF 是一種文件，其中所有的顏色和色調都使用灰階來表示，而非全彩譜。 當您啟用灰階選項時，IronPDF 的 [ Chrome 渲染引擎](https://ironpdf.com/how-to/ironpdf-2021-chrome-rendering-engine-eap/)會使用業界標準的亮度計算，自動將所有 RGB 顏色值轉換為相對應的灰階等值。 這可確保保留原始文件的視覺層次與對比，同時移除所有顏色資訊。

何時應該使用灰階 PDF？ IronPDF 以灰度而非彩色渲染 PDF 文件。 對於大量列印來說，以灰階模式列印 PDF 文件是一種經濟高效的方法。 當原始顏色過亮或過鮮豔時，以灰階渲染可增強可讀性。 灰階 PDF 具有更高的跨裝置、軟體和平台相容性，可確保一致的檢視和列印體驗。 灰階 PDF 的常見用例包括 - **商業報告**：灰階的財務文件通常看起來更專業 - **法律文件**：法庭文件和法律簡報通常需要灰階格式化 - **學術論文**：研究論文和畢業論文通常以灰階格式印刷 - **大量印刷**：打印數百頁時，灰階可降低成本 - **存檔文件**：長期儲存和[IronPDF/A合規性](https://ironpdf.com/how-to/pdfa/)的理想選擇

轉換為灰階時，文字會發生什麼變化？ 目前的灰階功能實作會將渲染 PDF 文件中的文字轉換成影像，導致 `ExtractAllImages` 方法無法輸出任何文字。 目前，此功能僅在渲染 PDF 時可用。 未來的更新可能包括將現有 PDF 文件轉換為灰階的功能。 如需更多有關文字萃取的工作資訊，請參閱我們的 [Extract Text & Images](https://ironpdf.com/how-to/extract-text-and-images/) 指南。 <！--說明：說明程式碼概念的圖表或截圖 --> ```csharp :path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-grayscale.cs ``` ## 進階灰階 PDF 生成範例 ### 將 HTML 檔案轉換為灰階 PDF 檔案 在處理本地 HTML 檔案時，您可以將其轉換為灰階 PDF。 當您有預先設計好的範本或報告需要呈現而不需要顏色時，這就很有用了。 進一步瞭解 [將 HTML 檔案轉換為 PDF](https://ironpdf.com/how-to/html-file-to-pdf/) 的相關資訊。 ```csharp 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"); ``` ### 從 HTML 字串建立灰階 PDF 對於動態內容的產生，可直接將 HTML 字串轉換為灰階 PDF。 此方法適用於產生發票、收據或任何以程式化方式建立內容的文件。 如需詳細資訊，請參閱我們的 [HTML 字串轉換為 PDF 的指南](https://ironpdf.com/how-to/html-string-to-pdf/)。 ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); renderer.RenderingOptions.GrayScale = true; // HTML content with inline CSS string htmlContent = @"

This colorful invoice will be rendered in grayscale.

Highlighted sections maintain contrast in grayscale.

"; var pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("invoice_grayscale.pdf"); ``` <！--說明：彩色 PDF 轉換為灰階的前後比較 --> ## 效能考量 生成灰階 PDF 時，請考慮這些效能因素： 1.**檔案大小**：灰階 PDF 比彩色版本小，非常適合電子郵件附件和網路下載。 2.**渲染速度**：灰階轉換對呈現時間的影響極小 3.**記憶體使用量**：灰階呈現比全彩呈現使用較少的記憶體，對大型文件有利 為了在產生多個灰階 PDF 時獲得更好的效能，請使用 [async 和多執行緒技術](https://ironpdf.com/how-to/async/)。 ## 與其他 IronPDF 功能整合。 將灰階 PDF 與其他 IronPDF 功能結合，進行全面的文件處理： - **頁首與頁尾**：使用我們的 [ 標題和頁尾指南](https://ironpdf.com/how-to/headers-and-footers/)，為您的灰階文件加入專業的標題和頁尾。 - **頁碼**：按照我們的[頁碼教學](https://ironpdf.com/how-to/page-numbers/)，在您的灰階 PDF 中包含頁碼。 - **水印**：在灰階 PDF 上套用水印以建立品牌或安全性 - **PDF 壓縮**：結合灰階呈現與 [PDF 壓縮](https://ironpdf.com/how-to/pdf-compression/)，進一步縮小檔案大小 ## 灰階 PDF 生成的最佳實務 1.**測試顏色對比**：在轉換前確保元素之間有足夠的對比。 2.**使用語義 HTML**：結構良好的 HTML 能產生更好的灰階轉換結果 3.**考慮可讀性**：灰階 PDF 可以改善某些視障人士的可讀性 4.**製作前先預覽**：在產生大批量灰階輸出前，請務必先行預覽 ## 疑難排解常見問題 如果遇到灰階 PDF 生成問題： 1.**文字顯得模糊**：在您的呈現選項中使用適當的 DPI 設定 2.**影像看起來很粗糙**：在轉換之前調整來源影像的對比度 3.**效能問題**：針對經常產生的灰階 PDF 實作快取 如需詳細的疑難排解，請造訪我們的 [全面疑難排解指南](https://ironpdf.com/troubleshooting/pixel-perfect-html-formatting/)。 準備好看看您還能做些什麼嗎？ 請造訪我們的教學頁面：[轉換 PDF 文件](https://ironpdf.com/tutorials/convert-pdf/)