如何在 C# 中使用IronPDF的 Cookie 進行 HTML轉PDF

什麼是 RequestContext 屬性？

在套用 cookie 之前，請將RequestContext屬性設為 RequestContexts.Global。 建立 ChromeHttpLoginCredentials 類別並將其傳遞給 ApplyCookies 方法。 然後渲染器將帶有 cookie 的 HTML 內容渲染成 PDF。

RequestContext 屬性與HTTP 請求標頭和驗證有關。 它決定渲染會話之間的 cookie 共享，這對於在多個 PDF 生成過程中保持會話狀態的應用程式至關重要。

如何使用 ApplyCookies 方法？

使用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)

當將ASPX 頁面轉換為需要驗證的 PDF或使用ASP.NET MVC 應用程式時，此方法有效。

我該選擇哪個 RequestContext？

RequestContexts 枚舉定義了瀏覽器請求上下文，建立了渲染之間的關係。 它管理 cookie 和用戶偏好設定。

-隔離：建立新的、隔離的請求上下文。 防止目前渲染結果受到先前渲染結果的影響。 非常適合多線程PDF生成。 -全域：在所有渲染之間使用共享的全域請求上下文。 在渲染過程中保持瀏覽器狀態。 非常適合在 PDF 操作過程中維護會話資料。 -自動：預設為 IronPdf.Rendering.RequestContexts.Isolated。 如果呼叫了 IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials)，則切換到 IronPdf.Rendering.RequestContexts.Global。

在Blazor Server 應用程式中實作 cookie 時，請選擇適當的 RequestContext 來維護伺服器端渲染之間的正確會話狀態。

IronPDF中的自訂 Cookie 是什麼？

自訂 Cookie 需要設定CustomCookies屬性。 此屬性接受字串鍵值對字典。 自訂 cookie 可處理複雜的身份驗證系統或在渲染期間傳遞應用程式層級的資料。

自訂 cookie 與標準 HTTP cookie 的區別在於，它允許定義任何鍵值對。 這種靈活性適用於使用 JWT 令牌、會話 ID 或自訂身份驗證機制的現代 Web 應用程式。

如何實作自訂 Cookie？

使用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)

這種方法適用於依賴 cookie 進行狀態管理或實施自訂日誌記錄解決方案的 JavaScript 密集型網站。

何時應該使用自訂 Cookie，何時應該使用標準 Cookie？

自訂 cookie 處理標準 HTTP 憑證無法管理的特定會話資料或驗證令牌。 可與自訂身份驗證系統搭配使用，或在產生 PDF 時保留使用者偏好設定。

標準 cookie(透過 ApplyCookies 方法)適用：

• 基本 HTTP 驗證
• Windows 驗證環境
• 簡單的會話管理

自訂 cookie 的優勢：

• 基於 JWT 令牌的身份驗證
• 具有多個參數的複雜會話管理
• 第三方身分驗證提供者(OAuth、SAML) 使用者偏好和設定維護 分析和追蹤要求

Cookie實施中常見的問題有哪些？

常見問題包括使用 Isolated 上下文時 cookie 無法在渲染之間保留、由於 cookie 值不正確而導致的身份驗證失敗，以及 cookie 在 PDF 生成之前過期的時間問題。 驗證 cookie 的有效性，並考慮持久會話的 Global 上下文。

故障排除提示：

1. Cookie 過期：驗證 cookie 是否已過期。 實作短期令牌的刷新邏輯。 2.網域限制：確保 cookie 網域與渲染後的 URL 相符。 3.安全 Cookie ：在渲染 HTTPS URL 時正確設定安全 Cookie。
2. SameSite 策略：考慮影響跨網域請求的瀏覽器 SameSite cookie 策略。

有關高級身份驗證和 cookie 方案，請參閱渲染選項文檔，其中涵蓋所有可用的 PDF 生成自訂設定。