如何在 C# 中儲存 PDF 檔案（入門教學）

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(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!");
    }
}

以下是該方法的詳細步驟說明：

1. 此方法呼叫getFilePath方法來取得 PDF 檔案將保存的檔案路徑。
2. 如果檔案路徑不為空或 null，則方法繼續儲存 PDF 檔案。
3. 此方法建立ChromePdfRenderer類別的新實例。 這是一個函式庫，它提供了一種使用GoogleChrome瀏覽器引擎將HTML內容轉換為PDF文件的方法。
4. 然後，該方法使用ChromePdfRenderer類別的RenderHtmlAsPdf 方法將文字方塊pdfContent的 HTML 內容轉換為 PDF 文件。 此PDF文件已指派給PdfDocument變數。
5. 此方法使用PdfDocument類別的SaveAs 方法將 PDF 文件儲存到指定的檔案路徑。
6. 最後，方法會顯示一個訊息框，指示 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 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;
}

以下是該方法的詳細步驟說明：

1. 此方法建立SaveFileDialog類別的新實例。 該類是 Windows Forms 庫的一部分，它提供了一個對話框，允許使用者選擇 PDF 文件保存的文件路徑。
2. 此方法設定SaveFileDialog物件的幾個屬性，以自訂其行為。 InitialDirectory屬性設定對話方塊首次開啟的目錄。 Title屬性用於設定對話方塊的標題。 CheckPathExists屬性指定對話方塊是否應檢查指定的路徑是否存在。 DefaultExt屬性設定檔案類型的預設檔案副檔名。 Filter屬性設定對話方塊中顯示的檔案類型篩選器。 FilterIndex屬性設定要顯示的預設篩選條件。 最後， RestoreDirectory屬性指定對話方塊在關閉前是否應還原目前目錄。
3. 此方法透過呼叫其ShowDialog方法來顯示SaveFileDialog 。 此方法顯示對話方塊並傳回DialogResult值，該值指示使用者是點選了"確定"按鈕還是"取消"按鈕。
4. 如果使用者按一下"確定"按鈕，則該方法將透過存取SaveFileDialog的FileName屬性傳回使用者選擇的檔案路徑。
5. 如果使用者點擊"取消"按鈕或關閉對話框，該方法將傳回空字串。

我們運行一下項目，看看輸出結果。 運行項目後，將開啟以下表單。

如何在 C# 中儲存 PDF 檔案（入門教學），圖 7：執行 Windows 窗體項目 運行 Windows Forms 項目

輸入您的 PDF 內容，然後點擊如下所示的"儲存"按鈕。

如何在 C# 中儲存 PDF 檔案（入門教學），圖 8：儲存對話框 儲存對話框

已產生以下PDF文件。

如何在 C# 中儲存 PDF 文件（入門教學），圖 9：已建立的 PDF 文件 已建立 PDF 文件

IronPDF 提供了一種簡單的方法，可以使用ChromePdfRenderer類和SaveFileDialog對話框將 HTML 內容轉換為 PDF 文件，並將其儲存到使用者選擇的文件路徑。