Jak wygenerować PDF w skali szarości w C#

Updated: 4 czerwca 2026

IronPDF umożliwia renderowanie PDFów w odcieniach szarości przez ustawienie właściwości GrayScale na true w RenderingOptions, konwertując kolorową zawartość na odcienie szarości dla ekonomicznego wydruku i lepszej czytelności.

Szybki start: Konwersja kolorowych PDF-ów na skalę szarości przy użyciu IronPDF

Przekształć kolorowe PDF-y w skalę szarości przy użyciu IronPDF za pomocą kilku linii kodu. Ustaw właściwość GrayScale w RenderingOptions, aby renderować strony internetowe lub zawartość HTML do PDFów w odcieniach szarości. Ten przewodnik pokazuje, jak generować dokumenty w skali szarości dla spójnej wizualizacji.

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

2Skopiuj i uruchom ten fragment kodu.

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

3Wdrożenie do testowania w środowisku produkcyjnym

Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

Minimalny proces (5 kroków)

Pobierz bibliotekę IronPDF do renderowania PDF-ów w skali szarości
Utwórz instancję klasy ChromePdfRenderer
Ustaw właściwość GrayScale opcji RenderingOptions na true
Uzyskaj dostęp i renderuj dokument PDF z URL, ciągu HTML lub pliku
Wyeksportuj dokument PDF w skali szarości do żądanej lokalizacji

Jak wygenerować PDF w skali szarości?

Aby wygenerować PDF w odcieniach szarości, ustaw właściwość GrayScale obiektu RenderingOptions na true. Ta funkcja jest częścią kompleksowych opcji renderowania IronPDF, które dają dokładną kontrolę nad wyjściem PDF.

W dostarczonym fragmencie kodu funkcja odcieni szarości jest włączona po zainicjowaniu ChromePdfRenderer. Następnie renderuje stronę internetową, używając metody RenderUrlAsPdf. Kod również wyodrębnia tylko pierwszą stronę zrenderowanego PDF-a i zapisuje ją lokalnie. Jeśli jesteś nowy w IronPDF, zapoznaj się z naszym przewodnikiem szybkiego startu, aby zapoznać się z podstawami.

Dlaczego ustawienie `GrayScale` na True konwertuje kolory?

PDF w skali szarości to dokument, w którym wszystkie kolory i odcienie są reprezentowane za pomocą odcieni szarości zamiast pełnego spektrum kolorów. Gdy włączysz opcję GrayScale, silnik renderujący Chrome IronPDF automatycznie konwertuje wszystkie wartości kolorów RGB na ich odpowiedniki w odcieniach szarości, używając kalkulacji luminancji standardowej w branży. To zapewnia, że hierarchia wizualna i kontrast oryginalnego dokumentu są zachowane przy jednoczesnym usunięciu wszystkich informacji o kolorze.

Kiedy powinienem używać PDF-ów w skali szarości?

IronPDF renderuje dokumenty PDF w skali szarości zamiast koloru. Drukowanie dokumentów PDF w skali szarości jest bardziej ekonomiczne przy druku dużych partii. Renderowanie w skali szarości poprawia czytelność, gdy oryginalne kolory są nadmiernie jasne lub jaskrawe. PDF-y w skali szarości mają zwiększoną kompatybilność na różnych urządzeniach, oprogramowaniu i platformach, zapewniając spójne wrażenia podczas oglądania i drukowania.

Typowe zastosowania dla PDF-ów w skali szarości obejmują:

Raporty biznesowe: Dokumenty finansowe często wyglądają bardziej profesjonalnie w skali szarości
Dokumenty prawne: Akta sądowe i pisma procesowe zazwyczaj wymagają formatowania w skali szarości
Prace akademickie: Prace badawcze i rozprawy często drukuje się w skali szarości
Drukowanie wielko-skalowe: Skala szarości obniża koszty przy drukowaniu setek stron
Dokumenty archiwalne: Idealne do długoterminowego przechowywania i zgodności z PDF/A

Co dzieje się z tekstem podczas konwersji na skalę szarości?

Obecna implementacja funkcji Odcieni Szarości konwertuje tekst w renderowanym dokumencie PDF na obraz, co skutkuje tym, że metoda ExtractAllImages nie generuje żadnego tekstu.

Obecnie ta funkcjonalność jest dostępna tylko podczas renderowania PDF-ów. Przyszłe aktualizacje mogą obejmować możliwość konwersji istniejących dokumentów PDF na skalę szarości. Więcej informacji o pracy z wyodrębnianiem tekstu znajdziesz w naszym przewodniku Wyodrębnianie tekstu i obrazów.

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

Zaawansowane przykłady generowania PDF-ów w skali szarości

Konwersja plików HTML na PDF-y w skali szarości

Pracując z lokalnymi plikami HTML, możesz konwertować je na PDF-y w skali szarości. Jest to przydatne, gdy masz zaprojektowane wcześniej szablony lub raporty, które wymagają renderowania bez koloru. Dowiedz się więcej o konwersji plików HTML na 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")

Tworzenie PDF-ów w skali szarości z ciągów HTML

Dla dynamicznego generowania treści, konwertuj ciągi HTML bezpośrednio na PDF-y w skali szarości. Podejście to dobrze działa przy generowaniu faktur, rachunków lub dowolnych dokumentów, gdzie treść jest tworzona programowo. Więcej szczegółów można znaleźć w naszym przewodniku o konwersji ciągów HTML na 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")

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

Kwestie związane z wydajnością

Tworząc PDF-y w skali szarości, weź pod uwagę te czynniki wydajności:

Rozmiar pliku: PDF-y w skali szarości są mniejsze niż wersje kolorowe, idealne jako załączniki do e-maili i do pobrań z sieci
Szybkość renderowania: Konwersja na skalę szarości dodaje minimalne obciążenie do czasu renderowania
Użycie pamięci: Renderowanie w skali szarości wykorzystuje mniej pamięci niż renderowanie pełnokolorowe, co jest korzystne dla dużych dokumentów

Dla lepszej wydajności przy generowaniu wielu PDF-ów w skali szarości użyj technik asynchronicznych i wielowątkowych.

Integracja z innymi funkcjami IronPDF

Połącz PDF-y w skali szarości z innymi funkcjami IronPDF dla kompleksowego przetwarzania dokumentów:

Nagłówki i stopki: Dodaj profesjonalne nagłówki i stopki do swoich dokumentów w skali szarości, korzystając z naszego przewodnika nagłówki i stopki
Numery stron: Dodaj numerację stron w swoich PDF-ach w skali szarości, postępując zgodnie z naszym samouczkiem o numerach stron
Znak wodny: Zastosuj znaki wodne do PDF-ów w skali szarości dla branding lub bezpieczeństwa
Kompresja PDF: Zmniejsz rozmiar plików jeszcze bardziej, łącząc renderowanie w skali szarości z kompresją PDF

Najlepsze praktyki generowania PDF-ów w skali szarości

Testuj kontrast kolorów: Zapewnij wystarczający kontrast między elementami przed konwersją
Używaj semantycznego HTML: Dobrze zbudowany HTML zapewnia lepsze wyniki konwersji na skalę szarości
Zastanów się nad dostępnością: PDF-y w skali szarości mogą poprawić czytelność dla niektórych zaburzeń wzroku
Podgląd przed produkcją: Zawsze dokonuj podglądu wyjścia w skali szarości przed generowaniem dużych partii

Rozwiązywanie typowych problemów

Jeśli napotkasz problemy z generowaniem PDF-ów w skali szarości:

Tekst wygląda nieczytelnie: Użyj odpowiednich ustawień DPI w opcjach renderowania
Obrazy wyglądają na wyprane: Dostosuj kontrast źródłowego obrazu przed konwersją
Problemy z wydajnością: Zastosuj buforowanie dla często generowanych PDF-ów w skali szarości

Aby uzyskać szczegółowe informacje na temat rozwiązywania problemów, odwiedź nasz kompleksowy przewodnik rozwiązywania problemów.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Konwersja PDF-ów

Często Zadawane Pytania

Jak przekonwertowac kolorowy PDF na odcienie szarosci w C#?

Aby przekonwertowac kolorowy PDF na odcienie szarosci uzywajac IronPDF, stworz obiekt ChromePdfRenderer i ustaw wlasciwosc GrayScale w RenderingOptions na true. Nastepnie uzyj metod takich jak RenderUrlAsPdf, RenderHtmlAsPdf lub RenderHtmlFileAsPdf, aby wygenerowac swoj dokument PDF w odcieniach szarosci.

Jaki jest cel wlasciwosci GrayScale w RenderingOptions?

Wlasciwosc GrayScale w RenderingOptions IronPDF konwertuje wszystkie kolory w twoim PDF na odcienie szarosci. Kiedy jest ustawiona na true, silnik renderujacy Chrome IronPDF automatycznie oblicza wartosci luminancji kolorow RGB i konwertuje je na ich odpowiedniki w odcieniach szarosci, zachowujac hierarchie wizualna i kontrast.

Dlaczego powinnam uzywac PDFow w odcieniach szarosci zamiast kolorowych?

Renderowanie w odcieniach szarosci w IronPDF jest idealne do oszczednego drukowania, szczegolnie dla duzych operacji masowych. PDFy w odcieniach szarosci rowniez poprawiaja czytelnosc, gdy oryginalne kolory sa zbyt jasne, zapewniaja lepsza kompatybilnosc na roznych urzadzeniach i platformach oraz oferuja spojne doswiadczenia wizualne.

Czy moge konwertowac konkretne strony na odcienie szarosci, pozostawiajac inne w kolorze?

Z IronPDF mozesz renderowac dokumenty w odcieniach szarosci, a potem wyodrebnic konkretne strony uzywajac metod takich jak CopyPage. Chociaz caly dokument jest renderowany w odcieniach szarosci, kiedy wlasciwosc GrayScale jest wlaczona, mozesz laczyc rozne podejscia renderowania, aby tworzyc dokumenty z mieszana zawartoscia kolorowa i w odcieniach szarosci.

Jakie typy tresci mozna konwertowac na PDFy w odcieniach szarosci?

IronPDF moze konwertowac rozne typy tresci na PDFy w odcieniach szarosci, w tym strony internetowe poprzez RenderUrlAsPdf, ciagi HTML za pomoca RenderHtmlAsPdf i pliki HTML poprzez RenderHtmlFileAsPdf. Wszystkie typy tresci wspieraja opcje renderowania GrayScale dla spojnych rezultatow.