Cómo utilizar las cookies con IronPDF
Las cookies, en el contexto de la tecnología web, son pequeños fragmentos de datos que los sitios web almacenan en el ordenador o dispositivo del usuario. Sirven para varios propósitos, desde la gestión de sesiones, donde ayudan a mantener a los usuarios conectados, hasta el seguimiento y análisis, recopilando datos sobre el comportamiento del usuario para mejorar el sitio web. Sin embargo, el uso de cookies ha suscitado debates sobre la privacidad, lo que ha dado lugar a normativas como el GDPR y la CCPA, y los navegadores web modernos ofrecen a los usuarios un control sobre la gestión de las cookies para abordar estas preocupaciones.
Comience con IronPDF
Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.
Cómo utilizar las cookies con IronPDF
- Descargar IronPDF de NuGet
- Preparar el contenido HTML para renderizar con cookies personalizadas
- Configure el RequestContext para permitir el uso de cookies
- Utiliza el
ApplyCookies
método para aplicar cookies - Utiliza el CustomCookies para implementar cookies personalizadas
Aplicar cookies Ejemplo
Antes de utilizar el método para aplicar cookies, establezca la propiedad RequestContext a RequestContexts.Global. A continuación, crea la clase ChromeHttpLoginCredentials y pásala al método ApplyCookies
. El renderizador ya está listo para ser utilizado para renderizar contenido HTML a PDF con cookies.
: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)
Enum RequestContexts: Este enum define los contextos de solicitud del navegador utilizados para establecer relaciones entre renders individuales. Es esencial para gestionar las cookies y las preferencias de los usuarios.
- Aislado: Crea un nuevo contexto de solicitud aislado de renders anteriores o futuros. Recomendado para garantizar que el renderizado actual no se vea afectado por los anteriores.
- Global: Utiliza el contexto de petición global, que se comparte entre todos los renders. Útil en algunos casos para persistir ciertos estados del navegador entre renders.
- Auto: por defecto, IronPdf.Rendering.RequestContexts.Isolated, pero cambia a IronPdf.Rendering.RequestContexts.Global si el usuario ha invocado alguna vez IronPdf.ChromePdfRenderer.ApplyCookies.(System.String, IronPdf.ChromeHttpLoginCredentials).
Aplicar cookies personalizadas Ejemplo
El uso de cookies personalizadas en una solicitud requiere establecer la propiedad CustomCookies. Esta propiedad acepta un diccionario de pares clave-valor, ambos como cadenas.
: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)