如何在 C# 中使用 IronPDF 的 Cookies

IronPDF 使用 RequestContext 屬性和 ApplyCookies 方法將 cookie 整合到 PDF 渲染中，在 HTML 到 PDF 的轉換過程中維護會話資訊和用戶認證。

Cookies 是網站儲存在使用者裝置上的小型資料。 這些工具可以管理會話、追蹤使用者行為以及儲存偏好設定。 GDPR 和 CCPA 等隱私權法規增加了對 cookie 管理的重視，促使瀏覽器為使用者提供對 cookie 處理的更大控制。

在使用 IronPDF 的 Chrome 渲染引擎時，cookie 會在 HTML 到 PDF 的轉換過程中保持狀態。 在渲染需要 TLS 網站驗證和系統登入或使用者特定偏好設定的頁面時，這一點至關重要。

快速入門：在 IronPDF 中使用 Cookie

使用 IronPDF 將 Cookie 整合到您的 PDF 渲染流程中。 本指南演示了在 HTML 到 PDF 的轉換過程中使用 IronPDF API 管理 cookies。 使用 RequestContext 屬性和 ApplyCookies 方法，以最少的程式碼套用標準或自訂 cookies。

如何將 Cookie 應用於 PDF 渲染？ <！--說明：說明程式碼概念的圖表或截圖 -->

什麼是 RequestContext 屬性？ 在套用 cookies 之前，請將 **RequestContext** 屬性設定為 `RequestContexts.Global` 。 建立 `ChromeHttpLoginCredentials` 類，並將其傳給 `ApplyCookies` 方法。 然後，渲染器會將 HTML 內容渲染為帶有 cookies 的 PDF。 `RequestContext` 屬性與 [HTTP 請求標頭](https://ironpdf.com/how-to/http-request-header/)及驗證一起運作。 它決定了渲染階段之間的 cookie 共用，這對於在多個 PDF 世代中維持階段狀態的應用程式至關重要。

如何使用 ApplyCookies 方法？ <！--說明：說明程式碼概念的圖表或截圖 --> 使用 IronPdf 申請 cookies： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-cookies.cs ``` 這種方法在將 [ASPX 頁面轉換為需要驗證的 PDF](https://ironpdf.com/how-to/aspx-to-pdf/) 或 [ASP.NET MVC 應用程式](https://ironpdf.com/how-to/cshtml-to-pdf-mvc-core/)時也適用。

我應該選擇哪一種 RequestContext？ `RequestContexts` 枚舉定義了建立渲染之間關係的瀏覽器請求上下文。 它可以管理 cookie 和使用者偏好設定。 - **獨立的**：建立新的、隔離的請求上下文。 防止目前的渲染受先前渲染的影響。 適用於[多執行緒 PDF 產生](https://ironpdf.com/how-to/async/)。 - **全局**：在所有渲染之間使用共用的全局請求上下文。 在渲染之間保持瀏覽器狀態。 非常適合在 PDF 作業中維護會話資料。 - **自動**：預設為`IronPdf.Rendering.RequestContexts.Isolated`。 切換到 `IronPdf.Rendering.RequestContexts.Global` 如果 `IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials)` 被調用。 在 [Blazor Server 應用程式](https://ironpdf.com/how-to/blazor-tutorial/)中實作 cookies 時，請選擇適當的 RequestContext 以在伺服器端渲染之間維持適當的階段狀態。

---

如何套用自訂 Cookie？ <！--說明：說明程式碼概念的圖表或截圖 -->

什麼是 IronPDF 中的自訂 Cookie？ 自訂 cookie 需要設定 **CustomCookies** 屬性。 此屬性接受字串關鍵值對詞典。 自訂 cookies 可處理複雜的驗證系統，或在呈現過程中傳遞應用程式層級的資料。 自訂 Cookie 與標準 HTTP Cookie 不同，它允許任何鍵值對定義。 這種靈活性適合使用 JWT 令牌、會話 ID 或自訂驗證機制的現代網路應用程式。

如何實作自訂 Cookie？ 使用 IronPDF 套用自訂 cookies： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-custom-cookies.cs ``` 此方法適合[依賴 Cookie 進行狀態管理或實施自訂記錄解決方案](https://ironpdf.com/how-to/javascript-to-pdf/)的重度 JavaScript 網站。

何時應該使用自訂 Cookie vs 標準 Cookie？ 自訂 cookies 可處理標準 HTTP 認證無法管理的特定會話資料或驗證標記。 將它們與自訂驗證系統搭配使用，或在 PDF 生成過程中維護使用者偏好設定。 標準 cookies (透過 ApplyCookies 方法) 適用： - 基本 HTTP 認證 - Windows 認證環境 - 簡單的會話管理 自訂 Cookie excel 為： - 基於 JWT 令牌的驗證 - 多參數的複雜會話管理 - 第三方驗證提供者 (OAuth、SAML) - 使用者偏好與設定維護 - 分析與追蹤需求

Cookie 實作的常見問題有哪些？ 常見的問題包括使用 `Isolated` 上下文的 Cookie 在渲染之間無法持久化、因不正確的 Cookie 值導致認證失敗，以及 Cookie 在 PDF 生成之前過期的時間問題。 驗證 cookie 的有效性，並考慮使用 `Global` 上下文進行持久性會話。 疑難排解提示： 1.**Cookie 過期**：驗證 cookies 是否過期。 針對短期代幣實施刷新邏輯。 2.**網域限制**：確保 cookie 網域與呈現的 URL 相符。 3.**安全 Cookie**：在呈現 HTTPS URL 時正確設定安全 Cookie。 4.**SameSite 政策**：考慮影響跨源請求的瀏覽器 SameSite cookie 政策。 如需進階驗證及 cookie 方案，請參閱 [ 渲染選項說明文件](https://ironpdf.com/how-to/rendering-options/)，其中涵蓋所有可用的 PDF 生成自訂設定。