C# Kullanarak ASP.NET'te PDF Nasıl Oluşturulur?

Save_Click Yöntemi (PDF Belgesi Oluştur)

Aşağıdaki yöntem, bir düğme tıklama 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

İşte bu yöntemin yaptıklarının adım adım bir özeti:

1. Yöntem, PDF dosyasının kaydedileceği dosya yolunu almak için getFilePath metodunu çağırır.
2. Dosya yolu boş veya null değilse, yöntem PDF dosyasını kaydetmeye devam eder.
3. Yöntem, ChromePdfRenderer sınıfının yeni bir örneğini oluşturur. Bu, Google Chrome tarayıcı motorunu kullanarak HTML içeriğini PDF belgelerine dönüştürme yolu sağlayan bir kütüphanedir.
4. Daha sonra yöntem, metin kutusu pdfContent'nın HTML içeriğini bir PDF belgesine dönüştürmek için ChromePdfRenderer sınıfının RenderHtmlAsPdf Metodunu kullanır. Bu PDF belgesi, PdfDocument Değişkenine atanır.
5. Yöntem, belirli dosya yoluna PDF belgesini kaydetmek için PdfDocument sınıfının SaveAs Metodunu kullanır.
6. Son olarak, yöntem bir mesaj kutusu gösterir ve böylece PDF dosyasının başarıyla kaydedildiği belirtilir.

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

Bu yöntem, kullanıcının PDF dosyasının kaydedileceği dosya yolunu seçmesi için bir SaveFileDialog görüntülemek amacıyla kullanılır.

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

İşte bu yöntemin yaptıklarının adım adım bir özeti:

1. Yöntem, 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 dosya yolunu seçme fırsatı veren bir iletişim kutusu sağlar.
2. Yöntem, davranışını özelleştirmek için SaveFileDialog nesnesinin birkaç özelliğini ayarlar. InitialDirectory özelliği, iletişim kutusunun ilk olarak açılacağı dizini ayarlar. Title özelliği, iletişim kutusunun başlığını ayarlar. CheckPathExists özelliği, belirtilen yolun var olup olmadığını kontrol edip etmeyeceğini belirtir. 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, gösterilecek varsayılan filtreyi ayarlar. Son olarak, RestoreDirectory özelliği, iletişim kutusunun kapanmadan önce mevcut dizini geri yükleyip yüklemeyeceğini belirler.
3. Yöntem, SaveFileDialog'i ShowDialog yöntemini çağırarak gösterir. Bu yöntem, iletişim kutusunu görüntüler ve kullanıcının "Tamam" düğmesine mi yoksa İptal düğmesine mi tıkladığını belirten bir DialogResult değeri döndürür.
4. Kullanıcı "Tamam" düğmesine tıklarsa, yöntem SaveFileDialog'nın FileName özelliğine erişerek kullanıcının seçtiği dosya yolunu döndürür.
5. Kullanıcı "İptal" düğmesine tıklar veya iletişim kutusunu kapatırsa, yöntem boş bir dize döndürür.

Projeyi çalıştıralım ve çıktıyı görelim. Projeyi çalıştırın ve aşağıdaki form açılacak.

Windows Forms projesini çalıştırma

PDF içeriğinizi girin ve aşağıdaki 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 kullanıcı tarafından seçilen bir dosya yoluna kaydetmek için ChromePdfRenderer sınıfını ve SaveFileDialog iletişim kutusunu kullanarak basit bir yol sunar.