如何使用 IronPDF 的 Cookies 在 C# 中安全地生成 PDF

如何在 C# 中使用 IronPDF 的 Cookie

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

在網路技術領域,Cookie 是網站儲存在使用者電腦或裝置上的小型資料檔案。它們用途廣泛,從會話管理(幫助使用者保持登入)到追蹤和分析(收集使用者行為資料以改善網站)。 然而,cookie 的使用引發了關於隱私的討論,導致了 GDPR 和 CCPA 等法規的出台,現代網路瀏覽器為使用者提供了對 cookie 管理的控制權,以解決這些擔憂。

快速入門:在 IronPDF 中使用 Cookie

使用 IronPDF,您可以輕鬆地將 cookie 整合到 PDF 渲染過程中。 本快速指南向您展示如何使用 IronPDF API 管理 cookie,確保您的 HTML 到 PDF 轉換能夠保留會話資訊和使用者設定。 只需幾行程式碼,開發人員即可套用標準或自訂 cookie,利用RequestContext屬性和ApplyCookies方法實現無縫整合。 立即開始增強您的PDF文件!

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    new IronPdf.ChromePdfRenderer { RenderingOptions = { RequestContext = IronPdf.Rendering.RequestContexts.Global, CustomCookies = new Dictionary<string, string> { { "sessionId", "your_cookie_value" } } } }
        .RenderUrlAsPdf("https://example.com/protected")
        .SaveAs("secureWithCookies.pdf");
  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer


在使用該方法套用 cookie 之前,請將RequestContext屬性設定為RequestContexts.Global 。 然後,建立ChromeHttpLoginCredentials類別並將其傳遞給ApplyCookies方法。 現在渲染器已準備就緒,可用於將 HTML 內容渲染為具有 cookie 的 PDF。

以下是使用 IronPDF 應用 cookie 的範例:

:path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-cookies.cs
using IronPdf;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

ChromeHttpLoginCredentials credentials = new ChromeHttpLoginCredentials() {
    NetworkUsername = "testUser",
    NetworkPassword = "testPassword"
};

string uri = "http://localhost:51169/Invoice";

// Apply cookies
renderer.ApplyCookies(uri, credentials);
Imports IronPdf

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global

Dim credentials As New ChromeHttpLoginCredentials() With {
	.NetworkUsername = "testUser",
	.NetworkPassword = "testPassword"
}

Dim uri As String = "http://localhost:51169/Invoice"

' Apply cookies
renderer.ApplyCookies(uri, credentials)
$vbLabelText   $csharpLabel

RequestContexts列舉:此枚舉定義了用於建立各個渲染之間關係的瀏覽器請求上下文。 它對於管理 cookie 和使用者偏好至關重要。

  • Isolated :建立一個與先前或未來的渲染隔離的新請求上下文。 建議確保當前渲染不受先前渲染的影響。
  • Global :使用全域請求上下文,該上下文在所有渲染之間共用。 在某些情況下,可用於在渲染之間保持某些瀏覽器狀態。
  • Auto :默認為IronPdf.Rendering.RequestContexts.Isolated ,但如果用戶曾經調用過IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) ,則會切換到IronPdf.Rendering.RequestContexts.Global

在請求中使用自訂 cookie 需要設定CustomCookies屬性。 此屬性接受一個鍵值對字典,鍵和值均為字串類型。

以下是使用 IronPDF 應用自訂 cookie 的範例:

:path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-custom-cookies.cs
using IronPdf;
using System;
using System.Collections.Generic;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

Dictionary<string, string> customCookies = new Dictionary<string, string>();

// Apply custom cookies
renderer.RenderingOptions.CustomCookies = customCookies;

var uri = new Uri("https://localhost:44362/invoice");
PdfDocument pdf = renderer.RenderUrlAsPdf(uri);
Imports IronPdf
Imports System
Imports System.Collections.Generic

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private customCookies As New Dictionary(Of String, String)()

' Apply custom cookies
renderer.RenderingOptions.CustomCookies = customCookies

Dim uri As New Uri("https://localhost:44362/invoice")
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf(uri)
$vbLabelText   $csharpLabel

常見問題解答

如何在 C# 中將受 cookies 保護的網頁渲染為 PDF?

您可以使用 IronPDF 將受 cookies 保護的網頁渲染為 PDF,方法是將 RequestContext 設定為 RequestContexts.Global 並使用 CustomCookies 屬性指定您的 cookies。然後,使用網頁的 URL 來呼叫 RenderUrlAsPdf 方法。

RequestContext 屬性在 IronPDF 中的作用是什麼?

在 IronPDF 中,RequestContext 屬性決定了在 PDF 渲染期間如何管理 cookies 和瀏覽器狀態。它可以被設定為 IsolatedGlobalAuto,以控制渲染之間的狀態持久性。

將 HTML 呈現為 PDF 時,如何套用自訂 cookies?

若要在 IronPdf 中套用自訂 cookies,您需要設定 CustomCookies 屬性,其中包含代表您的 cookies 的鍵值對字典。這些 cookies 將會在 HTML 到 PDF 的渲染過程中套用。

IronPDF 中使用哪些方法管理 cookie?

IronPdf 使用 ApplyCookies 等方法和 CustomCookies 等屬性來管理 cookies。這些工具可讓您將會話或自訂 cookies 納入 PDF 渲染工作流程。

為什麼在 PDF 呈現中管理 cookies 很重要?

管理 PDF 呈現中的 cookies 對於維護使用者會話、啟用驗證功能,以及確保呈現的內容反映使用者特定的資料和偏好設定,都是非常重要的。這對於遵守 GDPR 和 CCPA 等隱私權法規也很重要。

ChromeHttpLoginCredentials 類如何協助 cookie 管理?

IronPDF 中的 ChromeHttpLoginCredentials 類用於在應用 Cookie 時傳遞登錄憑證,在 PDF 渲染過程中實現對會話的認證。

IronPdf 中有哪些不同類型的 RequestContexts?

IronPDF 提供三種類型的 RequestContextsIsolated 會為每次渲染建立新的上下文;Global 會在渲染中共享上下文;以及 Auto 會根據之前的 cookie 應用程式進行切換。

如何開始在 PDF 渲染中使用 IronPDF 進行 cookie 管理?

要開始在 PDF 渲染中使用 IronPDF 進行 cookie 管理,請從 NuGet 下載函式庫,準備您的 HTML 內容,配置 RequestContext 屬性,並根據需要使用 ApplyCookiesCustomCookies 方法。

IronPDF 在管理 cookie 和渲染 PDF 方面是否與 .NET 10 相容?

是 - IronPDF 與 .NET 10 完全相容。它支持 .NET 10 中引入的所有跨平台、性能和運行時改進,同時允許您管理 cookie、應用自訂 cookie、使用 ApplyCookiesCustomCookies 以及設定 RequestContext 就像在早期版本中一樣。

Chaknith Bin
軟體工程師
Chaknith 在 IronXL 和 IronBarcode 上工作。他對 C# 和 .NET 擁有深厚的專業知識,幫助改進了軟體並支持客戶。他從用戶互動中得到的見解有助於改善產品、文檔和整體體驗。
準備好開始了嗎?
Nuget 下載 16,493,056 | Version: 2025.11 剛發表