使用 IRONPDF

如何在C#中保存PDF檔案（初學者教程）

已更新 2024年3月10日

本文將探討如何使用 IronPDF 將 PDF 檔案從 Windows Forms 應用程式或任何 .NET 應用程式中儲存。

IronPDF 庫是一個 .NET 庫，提供簡單易用的類別和方法，用於在 C# 應用程序中生成和處理 PDF 文件。它允許開發人員只用幾行代碼就可以創建、修改和保存 PDF 檔，使其成為 Windows Forms 應用程式的絕佳選擇。

步驟 1：創建新的 Windows Forms 應用程式

首先，建立一個新的 Visual Studio 專案。以下是在 Visual Studio 2022 中創建新的 C# Windows Forms 應用程式的步驟：

如下圖所示打開 Visual Studio 2022。
Visual Studio 2022
在開始頁面上點擊「建立新專案」或前往「檔案」>「新增」>「專案」。
在「建立新專案」對話方塊中，選擇「Windows Forms 應用程式」或「Windows Forms App」(.NET框架)在「建立新專案」下，如下所示。
新表單應用程式
輸入您的專案名稱並選擇儲存位置。
專案位置
選擇 .NET Framework。從下拉菜單中選擇 .NET 7.0。
點擊 Create 按鈕。
附加信息
Visual Studio 會為您創建一個新的 C# Windows Forms 應用程式專案，並在專案中新增一個默認命名為“Form1”的表單，如下所示。
Form1 專案
就是這樣! 現在我們將開始使用設計器構建 Windows Forms 應用程式，新增控制項和功能以建立和儲存 PDF 文件檔案。

步驟 2：設計表單

您可以根據您的偏好設計表單。本教程將透過添加兩個標籤、一個富文本框和兩個按鈕來製作簡約設計。

如何在 C# 中保存 PDF 文件 (初學者教程)，圖 6：在表單中添加按鈕

將按鈕添加到表單

步驟 3：安裝 IronPDF

下一步是安裝 IronPDF 到此專案，以便使用其豐富的功能。

IronPDF 可以透過 Visual Studio 中的 NuGet 套件管理器安裝。您可以通過導航到工具 > NuGet 套件管理員 > 套件管理員主控台 來訪問 NuGet 套件管理員主控台。

輸入以下命令並按 Enter：

Install-Package IronPdf

此命令將在您的專案中下載並安裝 IronPDF 套件。安裝後，我們可以開始使用IronPDF。

程式碼撰寫以創建和儲存 PDF 文件

首先，在 Form1.cs 類別中撰寫兩個方法：Save_Click 和 getFilePath。這些方法一起使用以將文本框的內容儲存為 PDF 檔案，使用ChromePdfRenderer 類別圖書館讓我們逐一了解每個方法的工作原理。

Save_Click 方法 (建立 PDF 文件)

以下方法是按鈕點擊事件的事件處理程序。此方法的目的是將文本框的內容保存為 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(filePath))
    {
        // 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(filePath))
    {
        // 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(filePath) 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

VB C#

以下是此方法的逐步分解說明：

該方法呼叫 getFilePath 方法以獲取將儲存 PDF 檔案的檔案路徑。
如果檔案路徑不為空或 null，則該方法繼續保存 PDF 檔案。
此方法會建立一個新的 ChromePdfRenderer 類別實例。這是一個使用 Google Chrome 瀏覽器引擎將 HTML 內容轉換為 PDF 文件的庫。
該方法然後使用RenderHtmlAsPdf 方法使用 ChromePdfRenderer 類將文本框 pdfContent 的 HTML 內容轉換為 PDF 文件。此 PDF 文件被指派給PdfDocument 變數.
該方法使用指定的檔案路徑保存 PDF 文件。SaveAs 方法PdfDocument 類別。
最後，該方法顯示一個消息框，以指示 PDF 文件已成功保存。

getFilePath 方法（儲存 PDF 檔案）

此方法用於顯示 SaveFileDialog 給使用者，以選擇保存 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 "";
}

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

以下是此方法的逐步分解說明：

該方法會創建一個新的 SaveFileDialog 類別實例。此類別是 Windows Forms 程式庫的一部分，提供對話框讓使用者選擇將 PDF 文件儲存的檔案路徑。
該方法設置了 SaveFileDialog 對象的若干屬性以自定義其行為。 InitialDirectory 屬性設置對話框首次開啟時的目錄。 Title 屬性設定對話框的標題。 CheckPathExists 屬性指定對話框是否應檢查指定的路徑是否存在。 DefaultExt 屬性設定檔案類型的預設檔案副檔名。 Filter 屬性設定在對話框中顯示的文件類型篩選器。 FilterIndex 屬性設置要顯示的預設篩選器。最後，RestoreDirectory 屬性指定對話框在關閉前是否應恢復當前目錄。
此方法通過調用其 ShowDialog 方法來顯示 SaveFileDialog。此方法會顯示對話框並返回一個 DialogResult 值，以指示使用者是否點擊了“確定”按鈕或取消按鈕。
如果使用者按下 "OK" 按鈕，該方法將通過訪問 SaveFileDialog 的 FileName 屬性來返回使用者選擇的檔案路徑。
如果使用者點擊「取消」按鈕或關閉對話框，該方法將返回一個空字串。
讓我們運行項目來查看輸出。運行該專案，以下表單將會開啟。
執行 Windows Forms 專案
輸入您的 PDF 內容，然後按如下所示點擊 "Save" 按鈕。
儲存對話方塊
以下 PDF 已建立。
已創建的 PDF 檔案
IronPDF 提供了一種簡單的方法，透過使用 ChromePdfRenderer 類別和 SaveFileDialog 對話框，將 HTML 內容轉換為 PDF 文件並將其保存到用戶選擇的文件路徑。

結論

從 Windows Forms 應用程式儲存 PDF 文件是常見的需求，而 IronPDF 提供了一個易於使用且靈活的方法來完成這項任務。本文演示了如何在 C# Windows Forms 應用中使用 IronPDF 來創建、添加內容和保存文件。使用 IronPDF，開發人員只需幾行程式碼即可從他們的應用程式生成高品質的 PDF 檔案。

IronPDF 提供了多種功能，例如HTML 轉 PDF 轉換教學，PDF合併範例代碼, 分割 PDF 頁面指南，和提取文字和圖片指南，以及更多。 IronPDF 免費提供開發使用，並可在商業授權與免費試用，允許開發人員在商業項目中使用，並包括專業支援和更新。此外，IronPDF 是 Iron Suite這是一組 .NET 軟體元件的集合，包括用於條碼生成的庫(IronBarcode)建立、閱讀及操作Excel文件(IronXL), 處理文字提取(IronOCR)，以及更多。購買完整的 Iron Suite 是一種高性價比的解決方案，您可以用兩個產品的價格獲得所有五個產品。