如何在 C# 中使用 IronPDF 的 Cookie

什么是 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);

在将 ASPX 页面转换为需要验证的 PDF 时，或者在将 ASP.NET MVC 应用程序转换为 PDF 时，这种方法都能发挥作用。

我应该选择哪种 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 或自定义身份验证机制的现代网络应用程序。

如何实施自定义 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);

这种方法适合依赖 Cookie 进行状态管理或实施自定义日志记录解决方案的重JavaScript网站。

何时应使用自定义 Cookie 与标准 Cookie？

自定义 cookie 可处理标准 HTTP 凭证无法管理的特定会话数据或身份验证令牌。 将它们与自定义验证系统一起使用，或在 PDF 生成过程中维护用户首选项。

标准 cookie(通过 ApplyCookies 方法)适用：

• 基本 HTTP 身份验证
• Windows 身份验证环境
• 简单的会话管理

自定义 cookie excel 用于：

• 基于 JWT 令牌的身份验证
• 带有多个参数的复杂会话管理
• 第三方身份验证提供程序(OAuth、SAML)
• 用户偏好和设置维护
• 分析和跟踪要求

Cookie 实施中的常见问题有哪些？

常见问题包括使用 Isolated 上下文时 cookie 无法在渲染之间保留、由于 cookie 值不正确而导致的身份验证失败，以及 cookie 在 PDF 生成之前过期的时间问题。 验证 cookie 的有效性，并考虑持久会话的 Global 上下文。

故障排除提示：

1.Cookie过期：验证 cookie 是否过期。 为短期代币实施刷新逻辑。 2.域限制：确保 cookie 域与呈现的 URL 匹配。 3.安全 Cookie：在呈现 HTTPS URL 时正确配置安全 Cookie。 4.同一网站政策：考虑影响跨源请求的浏览器 SameSite cookie 政策。

有关高级身份验证和 cookie 场景，请参阅涵盖所有可用 PDF 生成自定义设置的 渲染选项文档。