如何在ASP.NET使用C#生成PDF
本文將探討如何使用IronPDF從Windows Forms應用程式或任何.NET應用程式保存PDF文件。
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 App"或"Windows Forms App (.NET Framework)",如下圖所示。
New Forms App -
為您的專案輸入一個名稱並選擇保存位置。
專案位置 - 選擇.NET Framework。 從下拉選單中選擇.NET 7.0。
-
點擊建立按鈕。
附加資訊 -
Visual Studio將為您建立一個新的C# Windows Forms應用程式專案,專案中將新增一個預設表單名為"Form1",如下圖所示。
Form1專案
完成了! 現在,我們將使用設計器開始構建Windows Forms應用程式,新增控件和功能以建立和保存PDF文件。
步驟2:設計表單
您可以按自己的喜好設計表單。 本教程將通過新增兩個標籤、一個豐富文字框和兩個按鈕來設計簡約風格。
向表單新增按鈕
步驟3:安裝IronPDF
下一步是在此專案中安裝IronPDF以使用其豐富的功能。
可以使用Visual Studio中的NuGet套件管理器安裝IronPDF。 您可以導航到NuGet套件管理器控制台,通過工具 > NuGet套件管理器 > 套件管理器控制台。
輸入以下命令並按下Enter鍵:
Install-Package IronPdf
此命令將在您的專案中下載並安裝IronPDF套件。 安裝完成後,我們可以開始使用IronPDF。
編寫程式碼以建立和保存PDF文件
首先,編寫兩個方法:Form1.cs類中。 這些方法一起使用,將文字框的內容保存為PDF文件,使用ChromePdfRenderer Class程式庫。 我們來逐一了解每個方法是如何工作的。
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!");
}
}
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
以下是此方法的逐步拆解:
- 此方法調用
getFilePath方法以獲取保存PDF文件的檔案路徑。 - 如果檔案路徑不為空或null,此方法繼續保存PDF文件。
- 此方法建立
ChromePdfRenderer類的一個新實例。 這是一個程式庫,提供了一種使用Google Chrome引擎將HTML內容轉換為PDF文件的方法。 - 然後,此方法使用
ChromePdfRenderer類的RenderHtmlAsPdf方法將文字框pdfContent的HTML內容轉換為PDF文件。 此PDF文件被分配給PdfDocument變數。 - 此方法使用
PdfDocument類的SaveAs方法將PDF文件保存到指定的檔案路徑。 - 最後,此方法顯示一個消息框以指示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;
}
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
以下是此方法的逐步拆解:
- 此方法建立
SaveFileDialog類的一個新實例。 此類是Windows Forms程式庫的一部分,提供了一個對話框,允許使用者選擇保存PDF文件的位置。 - 此方法設置
SaveFileDialog物件的若干屬性以自定義其行為。InitialDirectory屬性設置對話框最初打開的目錄。Title屬性設置對話框的標題。CheckPathExists屬性指定對話框是否應檢查指定路徑是否存在。DefaultExt屬性設置檔案型別的預設檔案擴展名。Filter屬性設置在對話框中顯示的檔案型別過濾器。FilterIndex屬性設置要顯示的預設過濾器。 最後,RestoreDirectory屬性指定對話框關閉前是否應恢復當前目錄。 - 此方法通過調用
SaveFileDialog。 此方法顯示對話框並返回一個DialogResult值,指示使用者是否點擊了"確定"按鈕或取消按鈕。 - 如果使用者點擊了"確定"按鈕,此方法將通過存取
SaveFileDialog。 - 如果使用者點擊了"取消"按鈕或關閉了對話框,此方法將返回一個空字串。
我們來運行專案看看輸出。 運行專案,將打開如下表單。
運行Windows Forms專案
輸入您的PDF內容並按如下圖的"保存"按鈕。
保存對話框
以下是建立的PDF文件。
建立的PDF文件
IronPDF提供了一種簡單的方法,將HTML內容轉換為PDF文件,並使用SaveFileDialog對話框保存到使用者選擇的檔案路徑。
總結
從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是一個經濟實惠的解決方案,因為您可以以兩個產品的價格獲得所有五個產品。
常見問題
我如何在C# Windows Forms應用程式中儲存PDF檔案?
您可以通過使用IronPDF在C# Windows Forms應用程式中設置帶控制項(如文字框和按鈕)的表單,並實施Save_Click方法來渲染內容並使用ChromePdfRenderer類將其儲存為PDF。
設置Windows Forms應用程式以使用C#儲存PDF需要哪些步驟?
要設置Windows Forms應用程式以儲存PDF,請在Visual Studio中建立一個新專案,新增必需的控制項,如標籤和富文字框,並通過NuGet套件管理器安裝IronPDF以利用其PDF渲染功能。
我如何在C#中將HTML內容轉換為PDF?
您可以使用IronPDF的RenderHtmlAsPdf方法在C#中將HTML內容轉換為PDF,這允許您將HTML字串直接渲染成PDF文件。
Save_Click方法在PDF生成上下文中有何作用?
Save_Click方法作為應用程式中的事件處理器,負責捕獲按鈕的點擊事件以啟動將文字框內容渲染成PDF文件的過程,使用IronPDF的渲染類。
我如何在C#應用程式中提示使用者選擇儲存PDF的檔案路徑?
在C#應用程式中,您可以使用SaveFileDialog類來提示使用者選擇儲存PDF的檔案路徑,這允許您設置一個檔案選擇介面並返回儲存渲染PDF的路徑。
IronPDF提供哪些進階功能用於PDF操作?
IronPDF提供進階功能,如HTML到PDF轉換、PDF合併、分割PDF頁面和提取文字與圖片,為.NET應用程式中的PDF操作提供一個全面的工具套件。
在商業項目中使用IronPDF生成PDF是否有費用?
IronPDF用於開發目的是免費的並帶有試用授權。但對於商業項目,必須購買商業授權,其中包括專用支援和定期更新等好處。
什麼是Iron Suite,它如何使開發者受益?
Iron Suite是.NET程式庫的集合,包括用於條碼生成、Excel文件操作和PDF處理的工具。它為需要在其應用程式中具備多種功能的開發者提供了一個成本效益高的解決方案。
IronPDF是否與.NET 10相容,這對C#中的PDF儲存有什麼好處?
是的—IronPDF完全支援.NET 10,包括桌面、Web和跨平台項目型別。使用.NET 10製作可提高運行時性能、使現代C#增強功能可用,並與平台功能更加緊密整合,這有助於使使用IronPDF的RenderHtmlAsPdf和SaveAs方法進行PDF建立和儲存更高效。

