Schritt 1: Einrichten Ihres Visual Studio-Projekts für die C#-PDF-Erzeugung

Der allererste Schritt besteht darin, ein Visual Studio-Projekt zu erstellen. Für dieses Tutorial verwenden wir die Windows Forms-App-Vorlage, aber IronPDF funktioniert nahtlos mit Webanwendungen (ASP.NET), Konsolen-Apps, WPF und mehr.

Öffnen Sie Visual Studio.

Klicken Sie auf "Neues Projekt erstellen".

Wählen Sie "Windows Forms App (.NET Framework oder .NET Core)" aus den Vorlagen und klicken Sie dann auf 'Weiter'. Das folgende Fenster wird angezeigt. Benennen Sie Ihr Projekt (z. B. MyCSharpPdfGenerator).

> Projet benennen

Klicken Sie danach auf 'Weiter'. Wählen Sie aus dem Dropdown-Menü Ihr gewünschtes .NET-Framework aus (IronPDF unterstützt eine breite Palette).

.NET-Framework auswählen

Auf die Schaltfläche 'Erstellen' klicken. Das Projekt wird erstellt und ist bereit für den nächsten Schritt.

Schritt 2: Installieren der IronPDF C# Library - Ihr Schlüssel zur PDF-Erzeugung

IronPDF wird einfach mittels NuGet zu Ihrem Projekt hinzugefügt. Dies ist der empfohlene Weg, um sicherzustellen, dass Sie die neueste Version und alle notwendigen Abhängigkeiten haben.

Install-Package IronPdf

Schritt 3: Entwerfen einer einfachen Windows-Formularschnittstelle (optional)

Für dieses Tutorial erstellen wir eine einfache Benutzeroberfläche, um die PDF-Erstellung auszulösen. Wenn Sie eine Web- oder Konsolenanwendung erstellen, integrieren Sie die IronPDF-Logik direkt in Ihre Controller, Services oder Klassen.

Gehen Sie zum ToolBox in Visual Studio (Ansicht > ToolBox). Ziehen und platzieren Sie die folgenden Steuerelemente auf Ihrer Form1-Entwurfsoberfläche:

• A Label (z. B. um Ihrer Anwendung den Titel "C# PDF Generator Demo" zu geben).
• Ein RichTextBox (nennen Sie es PdfText) zur Eingabe von HTML/Text.
• Ein TextBox (benennen Sie es URL) zur Eingabe einer URL.

• Zwei Button-Steuerelemente.

  • Weisen Sie dem ersten Button den Text "PDF aus Text generieren" zu (benennen Sie ihn GeneratePDFFromTextButton).
  • Legen Sie den Text der zweiten Schaltfläche auf "PDF aus URL generieren" fest (benennen Sie sie GeneratePDFFromURLButton).

Schritt 4: Schreiben von C#-Code zur Generierung von PDFs aus Text/HTML

Nun fügen wir die C#-Logik hinzu. Doppelklicken Sie im Formulardesigner auf die Schaltfläche "PDF aus Text generieren" (GeneratePDFFromTextButton). Dadurch wird eine Ereignisbehandlungsmethode in Ihrer Form1.cs Datei erstellt.

Fügen Sie zunächst den IronPDF Namensraum am Anfang Ihrer Form1.cs-Datei hinzu:

using IronPdf;

using IronPdf;

Implementieren Sie anschließend den Ereignishandler click der Schaltfläche. Dieser Code liest Text (der Klartext oder HTML sein kann) aus dem RichTextBox und wandelt ihn in ein PDF-Dokument um.

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

Erläuterung des C#-PDF-Erstellungscodes:

• IronPdf.License.LicenseKey: Es ist ratsam, Ihren IronPDF Lizenzschlüssel festzulegen. Falls Sie einen solchen Schlüssel besitzen, entfernen Sie die Kommentarzeichen in der entsprechenden Zeile und ersetzen Sie "YourLicenseKey..." durch Ihren tatsächlichen Schlüssel. IronPDF funktioniert ohne Lizenzschlüssel, aber Dokumente werden nach der Testphase mit einem Wasserzeichen versehen.
• SaveFileDialog: Hiermit wird ein Standard-Windows-Dialog angezeigt, in dem der Benutzer den Speicherort und den Dateinamen für seine PDF-Datei auswählen kann.
• ChromePdfRenderer: Dies ist das Herzstück der HTML-zu-PDF-Funktion von IronPDF. Es verwendet eine eingebettete Chromium-Engine für maximale Treue.
• RenderHtmlAsPdf(PdfText.Text): Dieser einzelne Methodenaufruf nimmt den String-Inhalt aus Ihrem RichTextBox (der Rich HTML sein kann) und wandelt ihn in ein PDF-Dokumentobjekt um.
• SaveAs(filename): Diese Methode speichert das generierte PDF-Dokument unter dem vom Benutzer angegebenen Pfad.
• Die Verwendung der using-Anweisung für pdfDocument stellt sicher, dass die Ressourcen korrekt verwaltet werden.

Beachten Sie, wie IronPDF die potenziell komplexe Aufgabe der HTML-zu-PDF-Konvertierung in nur wenige wesentliche Codezeilen vereinfacht. Dies ist ein bedeutender Vorteil für Entwickler, die schnell und zuverlässig PDF C# generieren müssen.

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

Schritt 5: Schreiben von C#-Code zur Generierung von PDFs aus einer URL

Das Erzeugen eines PDF aus einer Live-Webseite ist eine weitere häufige Anforderung. IronPDF macht das genauso einfach. Doppelklicken Sie im Formulardesigner auf die Schaltfläche "PDF aus URL generieren" (GeneratePDFFromURLButton), um den zugehörigen Klick-Ereignishandler zu erstellen.

Fügen Sie den folgenden C#-Code hinzu:

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

Erläuterung:

• URL.Text: Dies übernimmt die URL-Zeichenfolge aus dem Steuerelement TextBox in Ihrem Formular.
• RenderUrlAsPdf(URL.Text): Diese leistungsstarke IronPDF Methode navigiert zur angegebenen URL, rendert deren Inhalt (einschließlich HTML, CSS, JavaScript und Bilder) und konvertiert ihn in ein PDF-Dokument.
• Die Fehlerbehandlung (try-catch) ist aus Gründen der Robustheit enthalten, da Netzwerkprobleme oder ungültige URLs auftreten können.

Schlussfolgerung: Vereinfachen Sie Ihre C# PDF-Erstellung mit IronPDF

Wie dieses Tutorial zeigt, bietet IronPDF eine bemerkenswert leistungsstarke und dennoch einfache Lösung für all Ihre C# PDF-Erstellungs-Anforderungen. Egal ob Sie komplexe HTML-Seiten mit komplexem CSS und JavaScript konvertieren, dynamische Berichte aus Daten generieren, PDFs aus Live-URLs erstellen oder robuste PDF-Bearbeitungsfunktionen innerhalb Ihrer .NET-Anwendungen benötigen, IronPDF bietet die Werkzeuge und die Leistung, um die Arbeit effizient zu erledigen.

Wenn Sie PDF C#-Projekte generieren, stehen Sie oft vor der Wahl zwischen kostenlosen Bibliotheken, die möglicherweise Einschränkungen bei der Renderingqualität oder Funktionalität haben, oder komplexeren Lösungen, die umfangreicher Boilerplate-Code erfordern. IronPDF zeichnet sich als umfassende, kommerziell unterstützte .NET-PDF-Bibliothek aus, die die Entwicklung optimiert, qualitativ hochwertigen Ausgaben garantiert und ein reichhaltiges Funktionsangebot über die grundlegende PDFs-Erstellung hinaus bietet.

Sind Sie bereit, die beste Möglichkeit zur Erstellung und Manipulation von PDFs in C# zu erleben?

• Starten Sie noch heute Ihre kostenlose IronPDF-Testversion
• Erforschen Sie detaillierte Dokumentation & weitere Beispiele
• Lizenzierungsoptionen anzeigen
• Entdecken Sie die Iron Suite: Erhalten Sie mehr .NET-Tools für weniger (Die Iron Suite enthält mehrere .NET-Bibliotheken und bietet ein großes Preis-Leistungs-Verhältnis, wenn Sie mit anderen Dokumentformaten oder Aufgaben arbeiten.)

Durch die Wahl von IronPDF rüsten Sie Ihre C#-Projekte mit einer führenden PDF-Generierungs- und Manipulationsmaschine aus, sparen wertvolle Entwicklungszeit und stellen jedes Mal professionelle, pixelgenaue PDF-Dokumente sicher. Erfahren Sie mehr über die Konvertierung von HTML zu PDF in C# mit diesem detaillierten Leitfaden.