如何在 C# 中使用 IronPDF 的 Cookie#.

什么是RequestContext属性？

在应用cookies之前，将RequestContexts.Global。 创建ApplyCookies方法。 然后，渲染器通过 Cookie 将 HTML 内容渲染为 PDF。

RequestContext属性与HTTP请求头和身份验证一起工作。 它确定了渲染会话之间的 cookie 共享，这对应用程序在多代 PDF 中保持会话状态至关重要。

如何使用ApplyCookies方法？

using 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 应用程序转换为 PDF 时，这种方法都能发挥作用。

我应该选择哪个RequestContext？

RequestContexts 枚举定义了浏览器请求上下文，用于建立渲染之间的关系。 它可以管理 cookie 和用户偏好。

• Isolated：创建新的、隔离的请求上下文。 防止当前渲染受之前渲染的影响。 适用于多线程 PDF 生成。
• Global：使用所有渲染间共享的全局请求上下文。 在渲染之间保持浏览器状态。 非常适合在 PDF 操作中维护会话数据。
• Auto：默认使用 IronPdf.Rendering.RequestContexts.Isolated。 如果调用了 IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials)，则切换到 IronPdf.Rendering.RequestContexts.Global。

在Blazor Server应用程序中实现cookie时，选择适当的RequestContext以在服务器端渲染之间维护正确的会话状态。

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones

首席软件工程师，Agorus Build

查看案例研究

什么是 IronPDF 中的自定义 Cookie？

CustomCookies属性。 该属性接受字符串键值对字典。 自定义 cookie 可以处理复杂的身份验证系统，或在渲染过程中传递应用级数据。

自定义 cookie 与标准 HTTP cookie 不同，允许定义任何键值对。 这种灵活性适合使用 JWT 标记、会话 ID 或自定义身份验证机制的现代网络应用程序。

如何实施自定义 Cookie？

using 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)

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

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

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

标准cookie（通过ApplyCookies方法）适用于：

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

自定义 cookie excel 用于：

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

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

常见问题包括使用Isolated上下文时cookie未在渲染之间持久化、由于cookie值错误导致身份验证失败、和在PDF生成前cookie过期的定时问题。 验证cookie的有效性，并考虑使用Global上下文来实现持久会话。

故障排除提示：

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

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