如何在 IronPDF 中使用 Cookie

查克尼特·宾

2023年十一月2日

更新 2025年一月8日

Translated

View the article in English

在网络技术的背景下，Cookies是网站在用户的计算机或设备上存储的小数据片段。它们具有各种用途，从会话管理开始，帮助保持用户登录状态，到跟踪和分析，收集用户行为数据以改进网站。然而，使用cookies已经引发了对隐私的讨论，导致了像GDPR和CCPA这样的法规的出台，现代网络浏览器提供了对cookie管理的用户控制来解决这些问题。

开始使用IronPDF

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：

如何在 IronPDF 中使用 Cookie

从 NuGet 下载 IronPDF
准备使用自定义 cookie 呈现 HTML 内容
配置RequestContext属性以启用 Cookie 的使用
使用ApplyCookies方法来应用Cookies
使用 CustomCookies 属性来实现自定义 cookies

应用 Cookies 示例

在使用方法应用cookies之前，将RequestContext属性设置为RequestContexts.Global。然后，创建 ChromeHttpLoginCredentials 类并将其传递给 ApplyCookies 方法。渲染器现在已经可以用于将带有 cookies 的 HTML 内容渲染为 PDF。

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

RequestContexts 枚举：此枚举定义了用于建立各个渲染之间关系的浏览器请求上下文。管理 cookie 和用户偏好设置是必不可少的。

隔离：创建一个与之前或未来的渲染隔离的新请求上下文。建议确保当前渲染不受之前渲染的影响。
全局：使用全局请求上下文，该上下文在所有渲染之间共享。在某些情况下，对于在渲染之间保持特定浏览器状态很有用。
自动：默认为IronPdf.Rendering.RequestContexts.Isolated，但如果用户曾调用过IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials)则切换到IronPdf.Rendering.RequestContexts.Global。

应用自定义Cookie示例

在请求中使用自定义 Cookie 需要设置 CustomCookies 属性。此属性接受一个键值对字典，键和值都是字符串。

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

查克尼特·宾

立即与工程团队聊天

软件工程师

Chaknith 是开发者中的福尔摩斯。他第一次意识到自己可能在软件工程方面有前途，是在他出于乐趣做代码挑战的时候。他的重点是 IronXL 和 IronBarcode，但他为能帮助客户解决每一款产品的问题而感到自豪。Chaknith 利用他从直接与客户交谈中获得的知识，帮助进一步改进产品。他的轶事反馈不仅仅局限于 Jira 票据，还支持产品开发、文档编写和市场营销，从而提升客户的整体体验。当他不在办公室时，他可能会在学习机器学习、编程或徒步旅行。