C#'ta PDF dosyası nasıl kaydedilir (Başlangıç Eğitimi)

Save_Click Yöntemi (PDF Belgesi Oluşturma)

Aşağıdaki yöntem bir buton-tıkla olayı için bir olay işleyicisidir. Bu yöntemin amacı, bir metin kutusunun içeriğini PDF dosyası olarak kaydetmektir.

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

Bu yöntemin ne yaptığının adım adım bir özeti:

1. Metot, PDF dosyasının kaydedileceği dosya yolunu almak için getFilePath metodunu çağırır.
2. Dosya yolu boş ya da null değilse, yöntem PDF dosyasını kaydetme işlemine devam eder.
3. Metot, ChromePdfRenderer sınıfının yeni bir örneğini oluşturur. Bu, Google Chrome tarayıcı motorunu kullanarak HTML içeriğini PDF belgesine dönüştürmek için bir yol sağlayan bir kütüphanedir.
4. Metot, metin kutusunun HTML içeriğini ChromePdfRenderer sınıfının RenderHtmlAsPdf Metodu ile PDF belgesine dönüştürür. Bu PDF belgesi, bir PdfDocument Değişkenine atanır.
5. Metot, PDF belgesini belirtilen dosya yoluna PdfDocument sınıfının SaveAs Metodu ile kaydeder.
6. Son olarak, yöntem PDF dosyasının başarıyla kaydedildiğini belirten bir mesaj kutusu gösterir.

getFilePath Yöntemi (PDF Dosyalarını Kaydetme)

Bu metot, kullanıcıya PDF dosyasının kaydedileceği dosya yolunu seçmesi için bir SaveFileDialog gösterir.

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

Bu yöntemin ne yaptığının adım adım bir özeti:

1. Metot, SaveFileDialog sınıfının yeni bir örneğini oluşturur. Bu sınıf, Windows Forms kütüphanesinin bir parçasıdır ve kullanıcıya PDF dosyasının kaydedileceği bir dosya yolu seçmesine olanak tanıyan bir dialog kutusu sağlar.
2. Metot, SaveFileDialog nesnesinin davranışını özelleştirmek için birçok özelliğini ayarlar. InitialDirectory özelliği, iletişim kutusunun ilk açılacağı dizini ayarlar. Title özelliği, iletişim kutusunun başlığını ayarlar. CheckPathExists özelliği, belirtilen yolun var olup olmadığını kontrol etmek isteyen iletişim kutusunun belirtimini ayarlar. DefaultExt özelliği, dosya türü için varsayılan dosya uzantısını ayarlar. Filter özelliği, iletişim kutusunda gösterilen dosya türü filtrelerini ayarlar. FilterIndex özelliği, varsayılan olarak gösterilecek filtreyi ayarlar. Son olarak, RestoreDirectory özelliği, kapatılmadan önce geçerli dizini geri yükleyip yüklemeyeceğini belirtir.
3. Metot, ShowDialog metodunu çağırarak SaveFileDialog gösterir. Bu metot, iletişim kutusunu gösterir ve kullanıcının "Tamam" veya İptal düğmesine tıklayıp tıklamadığını belirten bir DialogResult değeri döndürür.
4. Kullanıcı "Tamam" düğmesine tıklarsa, metot, kullanıcının seçtiği dosya yolunu SaveFileDialog'un FileName özelliğine erişerek döndürür.
5. Kullanıcı "İptal" düğmesine tıklarsa veya dialog kutusunu kapatırsa, yöntem boş bir dizgi döndürür.

Projeyi çalıştırıp çıktıyı görelim. Projeyi çalıştırın, ve aşağıdaki form açılacaktır.

Windows Forms projesini çalıştırma

PDF içeriğinizi girin ve aşağıda gösterildiği gibi "Kaydet" düğmesine tıklayın.

Kaydet iletişim kutusu

Aşağıdaki PDF oluşturuldu.

Oluşturulan PDF dosyası

IronPDF, HTML içeriğini PDF belgelerine dönüştürmek ve bunları ChromePdfRenderer sınıfı ve SaveFileDialog iletişim kutusu kullanarak kullanıcının seçtiği dosya yoluna kaydetmek için basit bir yol sağlar.