Cómo usar cookies con IronPDF para una generación segura de PDFs en C#

How to use Cookies with IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

Cookies, in the context of web technology, are small pieces of data that websites store on a user's computer or device. They serve various purposes, from session management, where they help keep users logged in, to tracking and analytics, collecting data on user behavior for website improvement. However, the use of cookies has sparked discussions on privacy, leading to regulations like the GDPR and CCPA, and modern web browsers offer users control over cookie management to address these concerns.

Quickstart: Using Cookies in IronPDF

Effortlessly integrate cookies into your PDF rendering process with IronPDF. This quick guide shows you how to use the IronPDF API to manage cookies, ensuring your HTML-to-PDF conversions maintain session information and user settings. With just a few lines of code, developers can apply standard or custom cookies, leveraging the RequestContext property and ApplyCookies method for seamless integration. Start enhancing your PDF documents today!

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { RequestContext = IronPdf.Rendering.RequestContexts.Global, CustomCookies = new Dictionary<string, string> { { "sessionId", "your_cookie_value" } } } }
        .RenderUrlAsPdf("https://example.com/protected")
        .SaveAs("secureWithCookies.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer


Apply Cookies Example

Before using the method to apply cookies, set the RequestContext property to RequestContexts.Global. Then, create the ChromeHttpLoginCredentials class and pass it to the ApplyCookies method. The renderer is now ready to be used for rendering HTML content to PDF with cookies.

Here's an example of applying cookies using IronPDF:

: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)
$vbLabelText   $csharpLabel

RequestContexts Enum: This enum defines browser request contexts used to establish relationships between individual renders. It's essential for managing cookies and user preferences.

  • Isolated: Creates a new request context that is isolated from previous or future renders. Recommended to ensure that the current render is not affected by previous renders.
  • Global: Uses the global request context, which is shared between all renders. Useful in some cases for persisting certain browser states between renders.
  • Auto: Defaults to IronPdf.Rendering.RequestContexts.Isolated but switches to IronPdf.Rendering.RequestContexts.Global if the user has ever invoked IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials).

Apply Custom Cookies Example

Using custom cookies in a request requires setting the CustomCookies property. This property accepts a dictionary of key-value pairs, both as strings.

Here's an example of applying custom cookies using IronPDF:

: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)
$vbLabelText   $csharpLabel

Preguntas Frecuentes

¿Cómo puedo renderizar una página web protegida con cookies a PDF en C#?

Puedes usar IronPDF para renderizar una página web protegida por cookies a PDF configurando el RequestContext a RequestContexts.Global y utilizando la propiedad CustomCookies para especificar tus cookies. Luego, llama al método RenderUrlAsPdf con la URL de la página web.

¿Cuál es el papel de la propiedad RequestContext en IronPDF?

En IronPDF, la propiedad RequestContext determina cómo se gestionan las cookies y los estados del navegador durante la representación del PDF. Se puede establecer en Isolated, Global, o Auto para controlar la persistencia de estados entre renders.

¿Cómo puedo aplicar cookies personalizadas al renderizar HTML a PDF?

Para aplicar cookies personalizadas en IronPDF, necesitas establecer la propiedad CustomCookies con un diccionario de pares clave-valor que representan tus cookies. Estas cookies se aplicarán durante el proceso de conversión de HTML a PDF.

¿Qué métodos se utilizan para gestionar cookies en IronPDF?

IronPDF utiliza métodos como ApplyCookies y propiedades como CustomCookies para gestionar cookies. Estas herramientas te permiten incorporar cookies de sesión o cookies personalizadas en tu flujo de trabajo de representación de PDF.

¿Por qué es importante gestionar cookies en la renderización de PDF?

Gestionar cookies en la renderización de PDF es crucial para mantener sesiones de usuario, habilitar la autenticación y asegurar que el contenido renderizado refleje datos y preferencias específicos del usuario. También es importante para el cumplimiento de regulaciones de privacidad como GDPR y CCPA.

¿Cómo ayuda la clase ChromeHttpLoginCredentials en la gestión de cookies?

La clase ChromeHttpLoginCredentials en IronPDF se utiliza para pasar credenciales de inicio de sesión al aplicar cookies, permitiendo la autenticación para sesiones durante el proceso de representación de PDF.

¿Cuáles son los diferentes tipos de RequestContexts en IronPDF?

IronPDF ofrece tres tipos de RequestContexts: Isolated, que crea un nuevo contexto para cada render; Global, que comparte contextos entre renders; y Auto, que cambia según la aplicación previa de cookies.

¿Cómo puedo empezar a usar IronPDF para la gestión de cookies en la renderización de PDF?

Para comenzar a usar IronPDF para la gestión de cookies en la representación de PDF, descarga la biblioteca desde NuGet, prepara tu contenido HTML, configura la propiedad RequestContext, y utiliza los métodos ApplyCookies y CustomCookies según sea necesario.

¿IronPDF es compatible con .NET 10 para administrar cookies y renderizar archivos PDF?

Sí, IronPDF es totalmente compatible con .NET 10. Admite todas las mejoras multiplataforma, de rendimiento y de tiempo de ejecución introducidas en .NET 10 y, al mismo tiempo, le permite administrar cookies, aplicar cookies personalizadas, usar ApplyCookies y CustomCookies y configurar RequestContext como en versiones anteriores.

Chaknith Bin
Ingeniero de Software
Chaknith trabaja en IronXL e IronBarcode. Tiene un profundo conocimiento en C# y .NET, ayudando a mejorar el software y apoyar a los clientes. Sus conocimientos derivados de las interacciones con los usuarios contribuyen a mejores productos, documentación y experiencia en general.
¿Listo para empezar?
Nuget Descargas 16,154,058 | Versión: 2025.11 recién lanzado