Graustufen-PDF in C#

Updated: 5. September 2026

IronPDF ermöglicht es Ihnen, PDFs in Graustufen darzustellen, indem Sie die Eigenschaft GrayScale auf true in RenderingOptions setzen, wobei Farbinhalt in Grautöne umgewandelt wird, um kostengünstigeres Drucken und verbesserte Lesbarkeit zu erreichen.

Schnellstart: Farb-PDFs mit IronPDF in Graustufen konvertieren

Mit IronPDF lassen sich farbige PDF-Dateien mit nur wenigen Zeilen Code in Graustufen umwandeln. Setzen Sie die Eigenschaft GrayScale im RenderingOptions, um Webseiten oder HTML-Inhalte in Graustufen-PDFs umzuwandeln. Dieser Leitfaden zeigt Ihnen, wie Sie Graustufendokumente für eine einheitliche Darstellung erzeugen.

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

2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

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

3Bereitstellen zum Testen in Ihrer Live-Umgebung

Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

Minimaler Arbeitsablauf (5 Schritte)

Herunterladen der IronPDF-Bibliothek zum Rendern von Graustufen-PDFs
Instanziierung der Klasse ChromePdfRenderer
Setzen Sie die GrayScale Eigenschaft von RenderingOptions auf true
Zugriff und Rendern eines PDF-Dokuments von einer URL, HTML-Zeichenfolge oder Datei
Exportieren Sie das Graustufen-PDF-Dokument an den gewünschten Ort

Wie generiere ich ein Graustufen-PDF?

Um ein Graustufen-PDF zu erzeugen, setzen Sie die Eigenschaft GrayScale des RenderingOptions auf true. Diese Funktion ist Teil der umfassenden Rendering-Optionen von IronPDF, mit denen Sie die PDF-Ausgabe genau steuern können.

Im bereitgestellten Code-Snippet wird die Graustufenfunktion nach der Instanziierung eines ChromePdfRenderer aktiviert. Anschließend wird eine Webseite mit der Methode RenderUrlAsPdf gerendert. Der Code extrahiert außerdem nur die erste Seite der gerenderten PDF-Datei und speichert sie lokal. Wenn Sie IronPDF noch nicht kennen, sollten Sie sich unseren Schnellstart-Leitfaden ansehen, um sich mit den Grundlagen vertraut zu machen.

Warum wird durch Setzen von `GrayScale` auf True Farben umgewandelt?

Ein Graustufen-PDF ist ein Dokument, in dem alle Farben und Schattierungen in Graustufen statt im Vollfarbspektrum dargestellt werden. Wenn Sie die Option GrayScale aktivieren, konvertiert IronPDF's Chrome-Rendering-Engine automatisch alle RGB-Farbwerte in ihre entsprechenden Graustufenäquivalente unter Verwendung von branchenüblichen Leuchtdichteberechnungen. Dadurch wird sichergestellt, dass die visuelle Hierarchie und der Kontrast Ihres Originaldokuments erhalten bleiben, während alle Farbinformationen entfernt werden.

Wann sollte ich Graustufen-PDFs verwenden?

IronPDF rendert PDF-Dokumente in Graustufen statt in Farbe. Das Drucken von PDF-Dokumenten in Graustufen ist kosteneffektiv für den Druck großer Mengen. Die Wiedergabe in Graustufen verbessert die Lesbarkeit, wenn die Originalfarben zu hell oder lebhaft sind. Graustufen-PDFs sind besser mit verschiedenen Geräten, Softwareprogrammen und Plattformen kompatibel und gewährleisten ein einheitliches Anzeige- und Druckverhalten.

Häufige Anwendungsfälle für Graustufen-PDFs sind:

Geschäftsberichte: Finanzdokumente sehen in Graustufen oft professioneller aus
Rechtliche Dokumente: Gerichtsakten und juristische Schriftsätze erfordern in der Regel eine Formatierung in Graustufen
Akademische Arbeiten: Forschungsarbeiten und Dissertationen werden in der Regel in Graustufen gedruckt
Druck in großen Mengen: Graustufen reduzieren die Kosten beim Druck von Hunderten von Seiten
Archivierte Dokumente: Ideal für die langfristige Speicherung und PDF/A-Konformität

Was passiert mit Text bei der Konvertierung in Graustufen?

Die aktuelle Implementierung der Graustufenfunktion wandelt Text im gerenderten PDF-Dokument in ein Bild um, wodurch die Methode ExtractAllImages keinen Text ausgibt.

Derzeit ist diese Funktionalität nur beim Rendern von PDFs verfügbar. Zukünftige Aktualisierungen könnten die Möglichkeit beinhalten, bestehende PDF-Dokumente in Graustufen zu konvertieren. Weitere Informationen zur Arbeit mit der Textextraktion finden Sie in unserem Leitfaden Texte und Bilder extrahieren.

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

Erweiterte Beispiele für die Erstellung von PDF-Dateien in Graustufen

Konvertierung von HTML-Dateien in Graustufen-PDFs

Wenn Sie mit lokalen HTML-Dateien arbeiten, können Sie diese in Graustufen-PDFs umwandeln. Dies ist nützlich, wenn Sie vorgefertigte Vorlagen oder Berichte haben, die ohne Farbe gerendert werden müssen. Erfahren Sie mehr über die Konvertierung von HTML-Dateien in 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")

Erstellen von Graustufen-PDFs aus HTML-Strings

Für die Generierung dynamischer Inhalte konvertieren Sie HTML-Strings direkt in PDF-Dateien mit Graustufen. Dieser Ansatz eignet sich gut für die Erstellung von Rechnungen, Quittungen oder anderen Dokumenten, deren Inhalt programmatisch erstellt wird. Weitere Einzelheiten finden Sie in unserem Leitfaden zur Konvertierung von HTML-Strings in 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")

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Erwägungen zur Leistung

Bei der Erstellung von Graustufen-PDFs sollten Sie diese Leistungsfaktoren berücksichtigen:

Dateigröße: Graustufen-PDFs sind kleiner als Farbversionen, ideal für E-Mail-Anhänge und Web-Downloads
Rendering-Geschwindigkeit: Die Graustufen-Konvertierung erhöht die Rendering-Zeit nur minimal
Speicherkapazität: Graustufen-Rendering verbraucht weniger Speicher als Vollfarb-Rendering, was bei großen Dokumenten von Vorteil ist

Für eine bessere Leistung bei der Erstellung mehrerer Graustufen-PDFs sollten Sie async- und Multithreading-Techniken verwenden.

Integration mit anderen IronPDF-Funktionen

Kombinieren Sie Graustufen-PDFs mit anderen IronPDF-Funktionen für eine umfassende Dokumentenverarbeitung:

Kopf- und Fußzeilen: Fügen Sie Ihren Graustufendokumenten professionelle Kopf- und Fußzeilen hinzu, indem Sie unsere Anleitung für Kopf- und Fußzeilen verwenden
Seitenzahlen: Fügen Sie Seitenzahlen in Ihre Graustufen-PDFs ein, indem Sie unser Seitenzahlen-Tutorial befolgen
Wasserzeichen: Anbringen von Wasserzeichen in Graustufen-PDFs für Branding oder Sicherheit
PDF-Komprimierung: Verringern Sie die Dateigröße durch die Kombination von Graustufen-Rendering und PDF-Komprimierung weiter

Best Practices für die Erstellung von PDF-Dateien in Graustufen

Test Farbkontrast: Stellen Sie vor der Konvertierung einen ausreichenden Kontrast zwischen den Elementen sicher
Verwenden Sie semantisches HTML: Gut strukturiertes HTML führt zu besseren Ergebnissen bei der Konvertierung in Graustufen
Berücksichtigen Sie Barrierefreiheit: PDF-Dateien in Graustufen können die Lesbarkeit für manche Sehbehinderungen verbessern
Vorprüfung vor der Produktion: Prüfen Sie die Graustufenausgabe immer in der Vorschau, bevor Sie große Stapel erstellen

Behebung häufiger Probleme

Wenn Sie Probleme mit der PDF-Graustufengenerierung haben:

Text erscheint verschwommen: Verwenden Sie geeignete DPI-Einstellungen in den Renderoptionen
Bilder sehen verwaschen aus: Quellbildkontrast vor der Konvertierung anpassen
Leistungsprobleme: Implementierung einer Zwischenspeicherung für häufig generierte Graustufen-PDFs

Ausführliche Informationen zur Fehlerbehebung finden Sie in unserer umfassenden Anleitung zur Fehlerbehebung.

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich unsere Tutorial-Seite hier an: PDFs konvertieren

Häufig gestellte Fragen

Wie konvertiere ich in C# eine farbige PDF-Datei in Graustufen?

Um ein Farb-PDF mit IronPDF in Graustufen zu konvertieren, instanziieren Sie ein ChromePdfRenderer-Objekt und setzen Sie die Eigenschaft GrayScale in RenderingOptions auf true. Verwenden Sie dann Methoden wie RenderUrlAsPdf, RenderHtmlAsPdf oder RenderHtmlFileAsPdf, um Ihr Graustufen-PDF-Dokument zu erzeugen.

Was ist der Zweck der Eigenschaft GrayScale in RenderingOptions?

Die Eigenschaft GrayScale in den RenderingOptions von IronPDF konvertiert alle Farben in Ihrer PDF-Datei in Grautöne. Wenn sie auf true gesetzt ist, berechnet die Chrome-Rendering-Engine von IronPDF automatisch die Luminanzwerte von RGB-Farben und konvertiert sie in ihre Graustufenäquivalente, wobei die visuelle Hierarchie und der Kontrast erhalten bleiben.

Warum sollte ich Graustufen-PDFs anstelle von Farb-PDFs verwenden?

Das Graustufen-Rendering von IronPDF ist ideal für den kosteneffizienten Druck, insbesondere bei großen Stapelverarbeitungen. Graustufen-PDFs verbessern auch die Lesbarkeit, wenn die Originalfarben zu hell sind, sorgen für eine bessere Kompatibilität zwischen verschiedenen Geräten und Plattformen und bieten ein konsistentes Anzeigeerlebnis.

Kann ich bestimmte Seiten in Graustufen umwandeln und andere in Farbe belassen?

Mit IronPDF können Sie Dokumente in Graustufen rendern und dann bestimmte Seiten mit Methoden wie CopyPage extrahieren. Während das gesamte Dokument in Graustufen gerendert wird, wenn die Eigenschaft GrayScale aktiviert ist, können Sie verschiedene Rendering-Durchläufe kombinieren, um gemischte Farb- und Graustufendokumente zu erstellen.

Welche Arten von Inhalten können in Graustufen-PDFs konvertiert werden?

IronPDF kann verschiedene Inhaltstypen in Graustufen-PDFs konvertieren, darunter Webseiten über RenderUrlAsPdf, HTML-Strings über RenderHtmlAsPdf und HTML-Dateien mit RenderHtmlFileAsPdf. Alle Inhaltstypen unterstützen die gleiche Graustufen-Rendering-Option für einheitliche Ergebnisse.

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.

Hairil Hasyimi Bin Omar

Jetzt mit dem Ingenieurteam chatten

Software Ingenieur

Bereit anzufangen?

Nuget Downloads 21,105,021|Version:2026.9gerade veröffentlicht

Kostenloser NuGet-Download

Gesamtanzahl der Downloads: 21,105,021

Lizenzen anzeigen

Wie man Graustufen-PDF-Dateien in C# erstellt

Auf GitHub ansehen

Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

Rechtsklick auf Referenzen, NuGet-Pakete verwalten
Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
Paket auswählen und installieren

Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $