Jak zapisać plik PDF w C# (Przewodnik dla początkujących)

Metoda Save_Click (utwórz dokument PDF)

Poniższa metoda jest procedurą obsługi zdarzenia kliknięcia przycisku. Celem tej metody jest zapisanie zawartości pola tekstowego jako pliku PDF.

private void Save_Click(object sender, EventArgs e)
{
    // Get the file path to save the PDF file.
    string filename = getFilePath();

    // If the file path is not empty or null, proceed with saving the PDF file.
    if (!String.IsNullOrEmpty(filename))
    {
        // Create a new instance of the ChromePdfRenderer class.
        var renderer = new ChromePdfRenderer();

        // Render the file contents of the text box as a PDF document using the ChromePdfRenderer.
        var pdfDocument = renderer.RenderHtmlAsPdf(pdfContent.Text);

        // Save the PDF document to the specified file path using the SaveAs method.
        pdfDocument.SaveAs(filename);

        // Show a message box to indicate that the PDF file has been saved successfully.
        MessageBox.Show("PDF has been saved Successfully!");
    }
}

private void Save_Click(object sender, EventArgs e)
{
    // Get the file path to save the PDF file.
    string filename = getFilePath();

    // If the file path is not empty or null, proceed with saving the PDF file.
    if (!String.IsNullOrEmpty(filename))
    {
        // Create a new instance of the ChromePdfRenderer class.
        var renderer = new ChromePdfRenderer();

        // Render the file contents of the text box as a PDF document using the ChromePdfRenderer.
        var pdfDocument = renderer.RenderHtmlAsPdf(pdfContent.Text);

        // Save the PDF document to the specified file path using the SaveAs method.
        pdfDocument.SaveAs(filename);

        // Show a message box to indicate that the PDF file has been saved successfully.
        MessageBox.Show("PDF has been saved Successfully!");
    }
}

Private Sub Save_Click(ByVal sender As Object, ByVal e As EventArgs)
	' Get the file path to save the PDF file.
	Dim filename As String = getFilePath()

	' If the file path is not empty or null, proceed with saving the PDF file.
	If Not String.IsNullOrEmpty(filename) Then
		' Create a new instance of the ChromePdfRenderer class.
		Dim renderer = New ChromePdfRenderer()

		' Render the file contents of the text box as a PDF document using the ChromePdfRenderer.
		Dim pdfDocument = renderer.RenderHtmlAsPdf(pdfContent.Text)

		' Save the PDF document to the specified file path using the SaveAs method.
		pdfDocument.SaveAs(filename)

		' Show a message box to indicate that the PDF file has been saved successfully.
		MessageBox.Show("PDF has been saved Successfully!")
	End If
End Sub

Oto szczegółowy opis działania tej metody:

1. Metoda wywołuje metodę getFilePath w celu uzyskania ścieżki do pliku, w którym zostanie zapisany plik PDF.
2. Jeśli ścieżka do pliku nie jest pusta ani nie ma wartości null, metoda przechodzi do zapisywania pliku PDF.
3. Metoda tworzy nową instancję klasy ChromePdfRenderer. Jest to biblioteka, która umożliwia konwersję treści HTML na dokumenty PDF przy użyciu silnika przeglądarki Google Chrome.
4. Następnie metoda wykorzystuje metodę RenderHtmlAsPdf klasy ChromePdfRenderer do konwersji zawartości HTML pola tekstowego pdfContent na dokument PDF. Ten dokument PDF jest przypisany do zmiennej PdfDocument.
5. Metoda ta zapisuje dokument PDF w określonej ścieżce pliku przy użyciu metody SaveAs klasy PdfDocument.
6. Na koniec metoda wyświetla okno komunikatu informujące o pomyślnym zapisaniu pliku PDF.

Metoda getFilePath (zapisywanie plików PDF)

Ta metoda służy do wyświetlenia użytkownikowi SaveFileDialog w celu wybrania ścieżki, w której zostanie zapisany plik PDF.

public string getFilePath()
{
    // Create a new instance of the SaveFileDialog class.
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();

    // Set the initial directory where the SaveFileDialog will open.
    saveFileDialog1.InitialDirectory = @"D:\";

    // Set the title of the SaveFileDialog.
    saveFileDialog1.Title = "Save the PDF Files";

    // Set the SaveFileDialog to check if the specified path exists.
    saveFileDialog1.CheckPathExists = true;

    // Set the default extension for the file type.
    saveFileDialog1.DefaultExt = ".pdf";

    // Set the filter to display only PDF files or all files.
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";

    // Set the filter index to display the PDF filter as the default.
    saveFileDialog1.FilterIndex = 2;

    // Set the RestoreDirectory property to true so that the SaveFileDialog
    // restores the current directory before closing.
    saveFileDialog1.RestoreDirectory = true;

    // Show the SaveFileDialog and get the result.
    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        // If the user clicked the OK button in the SaveFileDialog, return the selected file path.
        return saveFileDialog1.FileName;
    }
    // If the user did not click the OK button, return an empty string.
    return String.Empty;
}

public string getFilePath()
{
    // Create a new instance of the SaveFileDialog class.
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();

    // Set the initial directory where the SaveFileDialog will open.
    saveFileDialog1.InitialDirectory = @"D:\";

    // Set the title of the SaveFileDialog.
    saveFileDialog1.Title = "Save the PDF Files";

    // Set the SaveFileDialog to check if the specified path exists.
    saveFileDialog1.CheckPathExists = true;

    // Set the default extension for the file type.
    saveFileDialog1.DefaultExt = ".pdf";

    // Set the filter to display only PDF files or all files.
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";

    // Set the filter index to display the PDF filter as the default.
    saveFileDialog1.FilterIndex = 2;

    // Set the RestoreDirectory property to true so that the SaveFileDialog
    // restores the current directory before closing.
    saveFileDialog1.RestoreDirectory = true;

    // Show the SaveFileDialog and get the result.
    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        // If the user clicked the OK button in the SaveFileDialog, return the selected file path.
        return saveFileDialog1.FileName;
    }
    // If the user did not click the OK button, return an empty string.
    return String.Empty;
}

Public Function getFilePath() As String
	' Create a new instance of the SaveFileDialog class.
	Dim saveFileDialog1 As New SaveFileDialog()

	' Set the initial directory where the SaveFileDialog will open.
	saveFileDialog1.InitialDirectory = "D:\"

	' Set the title of the SaveFileDialog.
	saveFileDialog1.Title = "Save the PDF Files"

	' Set the SaveFileDialog to check if the specified path exists.
	saveFileDialog1.CheckPathExists = True

	' Set the default extension for the file type.
	saveFileDialog1.DefaultExt = ".pdf"

	' Set the filter to display only PDF files or all files.
	saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*"

	' Set the filter index to display the PDF filter as the default.
	saveFileDialog1.FilterIndex = 2

	' Set the RestoreDirectory property to true so that the SaveFileDialog
	' restores the current directory before closing.
	saveFileDialog1.RestoreDirectory = True

	' Show the SaveFileDialog and get the result.
	If saveFileDialog1.ShowDialog() = DialogResult.OK Then
		' If the user clicked the OK button in the SaveFileDialog, return the selected file path.
		Return saveFileDialog1.FileName
	End If
	' If the user did not click the OK button, return an empty string.
	Return String.Empty
End Function

Oto szczegółowy opis działania tej metody:

1. Metoda tworzy nową instancję klasy SaveFileDialog. Ta klasa jest częścią biblioteki Windows Forms i udostępnia okno dialogowe, które pozwala użytkownikowi wybrać ścieżkę, w której zostanie zapisany plik PDF.
2. Metoda ustawia kilka właściwości obiektu SaveFileDialog w celu dostosowania jego zachowania. Właściwość InitialDirectory określa katalog, w którym okno dialogowe zostanie otwarte jako pierwsze. Właściwość Title określa tytuł okna dialogowego. Właściwość CheckPathExists określa, czy okno dialogowe powinno sprawdzić, czy podana ścieżka istnieje. Właściwość DefaultExt ustawia domyślne rozszerzenie pliku dla danego typu pliku. Właściwość Filter określa filtry typów plików wyświetlane w oknie dialogowym. Właściwość FilterIndex ustawia domyślny filtr do wyświetlenia. Wreszcie, właściwość RestoreDirectory określa, czy okno dialogowe powinno przywrócić bieżący katalog przed zamknięciem.
3. Metoda wywołuje SaveFileDialog poprzez wywołanie jej metody ShowDialog. Ta metoda wyświetla okno dialogowe i zwraca wartość DialogResult, która wskazuje, czy użytkownik kliknął przycisk "OK", czy przycisk Anuluj.
4. Jeśli użytkownik kliknie przycisk "OK", metoda zwraca ścieżkę do pliku wybranego przez użytkownika poprzez dostęp do właściwości FileName obiektu SaveFileDialog.
5. Jeśli użytkownik kliknie przycisk "Anuluj" lub zamknie okno dialogowe, metoda zwraca pusty ciąg znaków.

Uruchommy projekt i zobaczmy wynik. Uruchom projekt, a otworzy się poniższy formularz.

Uruchamianie projektu Windows Forms

Wprowadź treść pliku PDF i kliknij przycisk "Zapisz", jak pokazano poniżej.

Okno dialogowe Zapisz

Powstaje następujący plik PDF.

Utworzono plik PDF

IronPDF zapewnia prosty sposób konwersji treści HTML na dokumenty PDF i zapisywania ich w wybranej przez użytkownika ścieżce plików przy użyciu klasy ChromePdfRenderer oraz okna dialogowego SaveFileDialog.