Krok 1: Konfiguracja projektu Visual Studio do generowania PDF w C

Pierwszym krokiem jest stworzenie projektu Visual Studio. Do tego tutoriala użyjemy szablonu Windows Forms App, ale IronPDF działa bezproblemowo z aplikacjami internetowymi (ASP.NET), aplikacjami konsolowymi, WPF i innymi.

Otwórz program Visual Studio.

⟨IMG-521-BG⟩Otwieranie Visual Studio dla projektu C#⟨IMG-521-EG⟩

Kliknij "Utwórz nowy projekt".

⟨IMG-522-BG⟩Tworzenie nowego projektu w Visual Studio dla generatora PDF w C#⟨IMG-522-EG⟩

Wybierz "Aplikacja Windows Forms (.NET Framework lub .NET Core)" z szablonów, a następnie kliknij 'Dalej'. Pojawi się następujące okno. Nazwij swój projekt (np., ⟨CODE-1438⟩).

⟨IMG-523-BG⟩Nazewnictwo projektu C# do generowania PDF⟨IMG-523-EG⟩ ⟩Nazewnictwo projektu

Następnie kliknij 'Dalej'. Z rozwijanego menu wybierz preferowaną wersję .NET Framework (IronPDF obsługuje szeroki zakres).

⟨IMG-524-BG⟩Wybieranie .NET Framework dla projektu IronPDF C#⟨IMG-524-EG⟩ Wybieranie .NET Framework

Kliknij przycisk "Utwórz". Projekt zostanie utworzony i gotowy do kolejnego kroku.

⟨IMG-525-BG⟩Stworzono projekt Visual Studio do generowania PDF w C#⟨IMG-525-EG⟩

Krok 2: Instalacja bibliotek IronPDF dla C# - Klucz do generowania PDF

IronPDF można łatwo dodać do projektu za pomocą NuGet. To jest zalecany sposób, aby mieć pewność, że masz najnowszą wersję i wszystkie niezbędne zależności.

Install-Package IronPdf

Krok 3: Projektowanie prostego interfejsu formularza Windows (Opcjonalne)

Dla tego tutoriala stworzymy podstawowy interfejs użytkownika do uruchamiania generowania PDF. Jeśli tworzysz aplikację internetową lub konsolową, zintegrowasz logikę IronPDF bezpośrednio wewnątrz kontrolerów, usług lub klas.

Przejdź do Paski Narzędzi w Visual Studio (Widok > Paski Narzędzi). Przeciągnij i upuść następujące kontrolki na powierzchnię projektową Form1:

• ⟨CODE-1441⟩ (np. tytuł aplikacji "Demo generatora PDF w C#").
• ⟨CODE-1442⟩ (nazwij go ⟨CODE-1443⟩) do wprowadzenia HTML/tekstu.
• ⟨CODE-1444⟩ (nazwij go ⟨CODE-1445⟩) do wprowadzenia adresu URL.

• Dwa ⟨CODE-1446⟩ kontrolki.

  • Ustaw tekst pierwszego przycisku jako "Generuj PDF z tekstu" (nazwij go ⟨CODE-1447⟩).
  • Ustaw tekst drugiego przycisku jako "Generuj PDF z adresu URL" (nazwij go ⟨CODE-1448⟩).

⟨IMG-527-BG⟩Projektowanie formularza Windows dla aplikacji do generowania PDF w C#⟨IMG-527-EG⟩

Krok 4: Pisanie kodu C# do generowania PDF z tekstu/HTML

Teraz dodajmy logikę C#. Kliknij dwukrotnie na przycisk "Generuj PDF z tekstu" (⟨CODE-1449⟩) w projektancie formularzy. To stworzy metodę obsługi zdarzeń w pliku ⟨CODE-1450⟩.

Najpierw dodaj przestrzeń nazw IronPDF na początku pliku ⟨CODE-1451⟩:

using IronPdf;

using IronPdf;

Imports IronPdf

Następnie zaimplementuj obsługę zdarzenia ⟨CODE-1452⟩ przycisku. Ten kod pobiera tekst (który może być zwykłym tekstem lub HTML) z ⟨CODE-1453⟩ i konwertuje go na dokument PDF.

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

Private Sub GeneratePDFFromTextButton_Click(ByVal sender As Object, ByVal e As EventArgs)
	' 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
	Dim saveFileDialog1 As 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 Then
		Dim filename As String = saveFileDialog1.FileName

		' The core of PDF generation from HTML/Text using IronPDF
		' IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
		Dim 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 pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text)
			pdfDocument.SaveAs(filename)
		End Using

		MessageBox.Show("PDF Generated Successfully at: " & filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
	End If
End Sub

Wyjaśnienie kodu generowania PDF w C#:

• ⟨CODE-1454⟩: Dobrą praktyką jest ustawienie klucza licencji IronPDF. Jeśli go masz, odkomentuj linię i zamień ⟨CODE-1455⟩ na swój rzeczywisty klucz. IronPDF działa bez klucza licencji, ale dokumenty będą miały znak wodny po okresie próbnym.
• ⟨CODE-1456⟩: To dostarcza standardowego okna dialogowego Windows dla użytkownika, aby wybrać lokalizację zapisu i nazwę pliku dla swojego PDF.
• ⟨CODE-1457⟩: To serce możliwości IronPDF w zakresie HTML-do-PDF. Używa wbudowanego silnika Chromium dla maksymalnej wierności.
• ⟨CODE-1458⟩: Ta pojedyncza metoda pobiera zawartość tekstową z ⟨CODE-1459⟩ (która może być bogatym HTML) i konwertuje ją na obiekt dokumentu PDF.
• ⟨CODE-1460⟩: Ta metoda zapisuje wygenerowany dokument PDF w ścieżce określonej przez użytkownika.
• Użycie instrukcji ⟨CODE-1461⟩ dla ⟨CODE-1462⟩ gwarantuje, że zasoby są zarządzane prawidłowo.

Zauważ, jak IronPDF upraszcza potencjalnie złożone zadanie, jak konwersja HTML do PDF, do zaledwie kilku kluczowych linii kodu. To znaczna przewaga dla programistów potrzebujących szybko i niezawodnie generować PDF w C#.

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

Krok 5: Pisanie kodu C# do generowania PDF z adresu URL

Generowanie PDF z aktywnej strony internetowej to kolejne powszechne wymaganie. IronPDF czyni to równie prostym. Kliknij dwukrotnie przycisk "Generuj PDF z URL" (⟨CODE-1464⟩) w projektancie formularzy, aby stworzyć jego obsługę zdarzeń kliknięcia.

Dodaj następujący kod C#:

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

Private Sub GeneratePDFFromURLButton_Click(ByVal sender As Object, ByVal e As EventArgs)
	' IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

	If String.IsNullOrWhiteSpace(URL.Text) Then
		MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning)
		Return
	End If

	Dim saveFileDialog1 As 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 Then
		Dim filename As String = saveFileDialog1.FileName
		Try
			Dim 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 pdfDocument = renderer.RenderUrlAsPdf(URL.Text)
				pdfDocument.SaveAs(filename)
			End Using
			MessageBox.Show("PDF from URL Generated Successfully at: " & filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
		Catch ex As Exception
			MessageBox.Show("Error generating PDF from URL: " & ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
		End Try
	End If
End Sub

Wyjaśnienie:

• ⟨CODE-1465⟩: Ta metoda pobiera ciąg URL z kontrolki ⟨CODE-1466⟩ na Twoim formularzu.
• ⟨CODE-1467⟩: Ta potężna metoda IronPDF nawigazuje do podanego URL, renderuje jego zawartość (w tym HTML, CSS, JavaScript i obrazy) i konwertuje ją na dokument PDF.
• Obsługa błędów (⟨CODE-1468⟩) jest włączona dla odporności, ponieważ mogą wystąpić problemy z siecią lub nieprawidłowe URL.

Podsumowanie: Uprość generowanie PDF w C# z IronPDF

Jak pokazuje ten tutorial, IronPDF dostarcza niezwykle potężne, a jednocześnie proste rozwiązanie dla wszystkich potrzeb generowania PDF w C#. Czy to konwersja złożonych stron HTML z zaawansowanym CSS i JavaScript, generowanie dynamicznych raportów z danych, tworzenie PDF z aktywnych adresów URL, czy też potrzebujesz zaawansowanych możliwości edycji PDF w swoich aplikacjach .NET, IronPDF oferuje narzędzia i wydajność, aby efektywnie zrealizować zadanie.

Kiedy generujesz projekt PDF w C#, często stajesz przed wyborem między darmowymi bibliotekami, które mogą mieć ograniczenia w zakresie wierności renderowania lub zestawów funkcji, a bardziej złożonymi rozwiązaniami wymagającymi znacznej ilości kodu szablonowego. IronPDF wyróżnia się jako wszechstronna, komercyjnie wspierana biblioteka PDF .NET która upraszcza rozwój, zapewnia wysokiej jakości wyniki i dostarcza bogaty zestaw funkcji poza podstawowym tworzeniem PDF.

Gotowy doświadczyć najlepszego sposobu generowania i manipulacji PDF w C#?

• Rozpocznij darmową próbę IronPDF już dziś
• Przeglądaj szczegółową dokumentację & więcej przykładów
• Zobacz opcje licencjonowania
• Odkryj Iron Suite: Zdobądź więcej narzędzi .NET za mniej (Iron Suite zawiera wiele bibliotek .NET, oferując świetną wartość, jeśli pracujesz z innymi formatami dokumentów lub zadaniami.)

Wybierając IronPDF, wyposażasz swoje projekty C# w wiodący silnik do generowania i manipulacji PDF, oszczędzając cenny czas programowania i zapewniając profesjonalnie wyglądające, pikselowe dokumenty PDF za każdym razem. Dowiedz się więcej o konwersji HTML do PDF w C# w tym szczegółowym przewodniku.