1. IronPDF
  2. 文件
  3. 入門

如何開始使用 IronPDF C# PDF 函式庫

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 是我們的全面而多功能的軟體庫，讓您能夠完全精細地控制在您的專案或工作流程中生成、編輯和匯出 PDF 文件。 以及輸出中的每個方面和細節。

這款強大的工具支援多種語言，包括C#、F#、VB.NET、Java等。 這是解決您 PDF 問題的最佳方案。 本文將介紹 C# IronPDF 安裝 方法。

開發用的免費軟體可以透過NuGet和直接下載取得。 請按照以下說明在您的 .NET 項目中開始將 HTML 轉換為 PDF。

如何安裝 IronPDF：選擇合適的模式：本地與遠端

IronPDF 提供兩種渲染 PDF 的模式——原生模式和遠程模式——以適應不同的開發環境：

  • Native Mode：最適合希望在本地執行所有內容的開發人員，適合現代 Windows、macOS 和 Linux 部署。 只需安裝 IronPDF package into your .NET project.
  • 遠端模式(IronPdfEngine)**：非常適合雲端和容器化環境，例如 Azure、AWS 和 Docker，其中相依性可以集中管理。 也非常適用於不受原生支援或舊版操作系統，例如 Windows Server 2012 和較不流行的 Linux 發行版。 只需安裝 IronPdf.Slim 封裝到您的.NET專案並託管 IronPdfEngine 在容器中。

使用 IronPDF 遠端引擎

[{我(

本機和引擎有什麼區別？

IronPDF 有一些性能密集的功能，您可以选择遠程執行。 雖然IronPDF不需要IronPdfEngine來運行，但將IronPdfEngine設置為遠程服務是一種可選的方法，可以避免在舊操作系統和移動環境上發生特定平台的Chrome兼容性問題。

使用引擎如何改變我使用 IronPDF 編碼的方式？

在使用引擎配置時，我們建議安裝 IronPdf.Slim 而不是從 NuGet 取得完整的 IronPdf 套件，因為引擎會管理原生套件中包含的所有額外內容。

PM> Install-Package IronPdf.Slim

安裝 IronPdf.Slim 後，透過將 IronPDF 指向您的 IronPdfEngine 實例來配置連線設定。 在應用程式啟動時添加以下代碼：(或在調用任何 IronPDF 方法之前)*:

// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
' Assuming that IronPdfEngine runs
' remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
VB   C#

)}]

如何將 IronPDF 函式庫安裝到 .NET 專案（原生）

安裝中C# PDF程式庫很簡單，花費不到5分鐘。

開發用的免費軟體可以通過 NuGet 和直接下載獲得，透過這個教程，我們將幫助您在 Visual Studio 中快速啟動。 請按照以下說明在您的 .NET 項目中開始將 HTML 轉換為 PDF。

逐步安裝C# PDF庫

Pdf In Csharp No Button related to 如何將 IronPDF 函式庫安裝到 .NET 專案（原生）

如何操作教程

方法一：通過 NuGet 安裝 IronPDF

使用以下幾個步驟來安装IronPDF NuGet 庫從 Visual Studio 內部。

  1. 在解決方案總管中，右鍵點擊 參考，管理 NuGet 包裹。

  2. 選擇瀏覽並搜索 IronPdf

  3. 選擇套件並安裝。
Install-Package IronPdf

還有 IronPDF NuGet 套件可用於特定部署麦金塔, Linux, Azure, Docker和 AWS 記錄在我們的IronPDF 高級 NuGet 安裝指南.

C# NuGet 程式庫用于 PDF

安裝與 NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
或
Java PDF JAR

下載 DLL

下載DLL

手動安裝到您的項目中

C# NuGet 程式庫用于 PDF

安裝與 NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
或
Java PDF JAR

下載 DLL

下載DLL

手動安裝到您的項目中

立即開始在您的專案中使用IronPDF，並享受免費試用。

第一步：
green arrow pointer

查看 IronPDF 上 Nuget 方便快速安裝和部署。擁有超過 800 萬次下載，它正在使用 C# 改造 PDF。

C# NuGet 程式庫用于 PDF nuget.org/packages/IronPdf/
Install-Package IronPdf

請考慮安裝 IronPDF DLL 直接下載並手動安裝到您的專案或GAC表單： IronPdf.zip

Dll Img related to 方法一：通過 NuGet 安裝 IronPDF

手動安裝到您的項目中

下載DLL

方法二：透過下載 DLL 安裝 IronPDF

IronPDF 的第二種安裝方式是通過下載進行。 請遵循以下快速且簡易的步驟：

以下是適用於特定平台的其他 IronPDF DLL 壓縮包：

  1. 下載並解壓縮適合您作業系統的 ZIP 文件到您的解決方案目錄中的 ~/Libs 這樣的位置。

  2. 在 Visual Studio 方案總管中，右鍵單擊「依賴項」並選擇「添加專案引用」。 選擇瀏覽並包含從zip中提取的所有dll。

    C# NuGet 程式庫用于 PDF

    安裝與 NuGet

    Install-Package IronPdf
    nuget.org/packages/IronPdf/
    或
    Java PDF JAR

    下載 DLL

    下載DLL

    手動安裝到您的項目中

    C# NuGet 程式庫用于 PDF

    安裝與 NuGet

    Install-Package IronPdf
    nuget.org/packages/IronPdf/
    或
    Java PDF JAR

    下載 DLL

    下載DLL

    手動安裝到您的項目中

    立即開始在您的專案中使用IronPDF，並享受免費試用。

    第一步：
    green arrow pointer

    查看 IronPDF 上 Nuget 方便快速安裝和部署。擁有超過 800 萬次下載，它正在使用 C# 改造 PDF。

    C# NuGet 程式庫用于 PDF nuget.org/packages/IronPdf/
    Install-Package IronPdf

    請考慮安裝 IronPDF DLL 直接下載並手動安裝到您的專案或GAC表單： IronPdf.zip

    Dll Img related to 方法二：透過下載 DLL 安裝 IronPDF

    手動安裝到您的項目中

    下載DLL

套用授權碼

在您的應用程式啟動時，使用 IronPDF 之前，請加入此代碼。 這種方法普遍有效且易於實施。

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
VB   C#

如果您不想使用內嵌代碼來應用許可證密鑰，請訪問 'IronPDF 授權金鑰探索替代方法的文章。

2. 授予對文件或文件夾的必要訪問權限

有時可能需要在您的電腦上為某些用戶或角色添加權限。

例如，每个應用程式域需要自己的臨時資料夾路徑和應用程式相同應用程式集區無法共享 TempFolderPath。

现在这是什么意思？

AppDomain 僅僅在某個進程中提供一個隔離層。 您認為是每個程序的事實上是每個AppDomain的。 每個相同應用程式池中的應用程式都需要其自己的臨時文件夾，以便完全獨立運作。

如果需要使用上述的任何疑難排解選項，您可以按以下方式設定權限：

  1. 右鍵點擊一個文件或文件夾

  2. 選擇屬性

  3. 選擇安全性

  4. 點擊編輯...

  5. 選擇所需的權限。

3. 設定安裝路徑

To renderHTML 為 PDFIronPDF 必須嵌入 Chromium，這是一款安全的網頁瀏覽器。 幸運的是，這個過程是完全自動化的。

如果 IronPDF 的 HTML 轉 PDF 拋出“渲染失敗”的例外，這種情況非常罕見，您可能需要將原生瀏覽器二進制文件解壓到適當的位置。 Temp 資料夾通常是理想的選擇。

注意：永遠不要將程式檔案放置在 Program Files 資料夾中。

設定 IronPdf.Installation.TempFolderPath

您可以通過設置 TempFolderPath 屬性來解壓到正確的位置。IronPdf.Installation對象如下所示：

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";

在更新路徑後，請記得清除開發和服務器上的所有臨時和緩存文件夾。 重新部署您的應用程式的乾淨版本。

在應用程式範圍設定臨時資料夾環境變數

IronPDF 在渲染和編輯 PDF 文檔時，可能會偶爾在系統臨時文件夾中生成臨時文件。 我們也可以設置 IronPdf.Installation.TempFolderPath 來解決這個問題，但環境 TempPath 目錄有時仍可能被第三方包使用。

要解決這個問題，我們可以在C#應用程序啟動時，將TempPath環境變量設置為整個應用程序。這確保了應用程序創建的所有臨時文件都存儲在一個可控位置。

using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf

' Set Application scope Temp Files Path.
' This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
Private MyTempPath = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code here..E.G.
Dim Renderer = New IronPdf.ChromePdfRenderer()
Dim Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
VB   C#

4. 權限與 IIS

在伺服器被鎖定的情況下，您可能需要給予 IIS 使用者权限。(IUSER)對您的安裝路徑資料夾，以及您的 Windows 和 Temp 資料夾擁有讀和寫的權限。

5. Microsoft Visual C++ 與 Windows 兼容性

IronPDF 需要在目標 Windows 機器上安裝 Microsoft Visual C++。如有必要，可以將其與應用程式安裝程式（例如 MSI）一起打包。

Microsoft Visual C++ 是一個 Windows 組件，通常在現代版本的 Windows 上都會有，除非它們被故意精簡過。

.NET Framework 可以以 32 位元運行(即使在 64 位平台上)因此，需要安裝 32 位和 64 位版本的 Visual C++。

在這裡您可以下載 Microsoft Visual C++.

6. Linux 兼容性

7. Docker 兼容性

-在 Docker 上部署 IronPDF已有良好的文件記錄。

  • 我們正式支援以下平台的Docker：Windows、Ubuntu、Debian、CentOS 和 Amazon Linux 2，並提供工作中的 Docker 文件.

8. Azure 兼容性

9. 亞馬遜 AWS Lambda 兼容性

AAmazon AWS Lambda 教程和支援包含。

10. macOS 兼容性

-官方支援 macOS 部署及開發使用 Rider 和 "Visual Studio for Mac" 都是受支持的