Comment utiliser les cookies avec IronPDF
Les cookies, dans le contexte de la technologie web, sont de petits éléments de données que les sites web stockent sur l'ordinateur ou l'appareil d'un utilisateur. Ils servent à diverses fins, de la gestion de session, où ils aident les utilisateurs à rester connectés, au suivi et à l'analyse, en recueillant des données sur le comportement des utilisateurs en vue d'améliorer le site web. Cependant, l'utilisation de cookies a suscité des discussions sur la protection de la vie privée, ce qui a conduit à des réglementations telles que le GDPR et le CCPA, et les navigateurs web modernes offrent aux utilisateurs un contrôle sur la gestion des cookies afin de répondre à ces préoccupations.
Commencez avec IronPDF
Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.
Comment utiliser les cookies avec IronPDF
- Télécharger IronPDF depuis NuGet
- Préparer le contenu HTML à rendre avec des cookies personnalisés
- Configurer le RequestContext propriété permettant l'utilisation de cookies
- Utiliser le
Appliquer les cookies
pour appliquer les cookies - Utiliser le Cookies personnalisés pour mettre en œuvre des cookies personnalisés
Appliquer l'exemple des cookies
Avant d'utiliser la méthode pour appliquer les cookies, définissez la propriété RequestContext sur RequestContexts.Global. Ensuite, créez la classe ChromeHttpLoginCredentials et passez-la à la méthode ApplyCookies
. Le moteur de rendu est maintenant prêt à être utilisé pour rendre du contenu HTML en PDF avec des 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)
Énumération RequestContexts : Cette énumération définit les contextes de demande du navigateur utilisés pour établir des relations entre les différents rendus. Il est essentiel pour gérer les cookies et les préférences des utilisateurs.
- Isolé : Crée un nouveau contexte de demande qui est isolé des rendus précédents ou futurs. Recommandé pour s'assurer que le rendu actuel n'est pas affecté par les rendus précédents.
- Global : utilise le contexte de demande global, qui est partagé entre tous les rendus. Utile dans certains cas pour conserver certains états du navigateur entre les rendus.
- Auto : La valeur par défaut est IronPdf.Rendering.RequestContexts.Isolated mais passe à IronPdf.Rendering.RequestContexts.Global si l'utilisateur a déjà invoqué IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials).
Exemple d'application de cookies personnalisés
L'utilisation de cookies personnalisés dans une requête nécessite la définition de la propriété CustomCookies. Cette propriété accepte un dictionnaire de paires clé-valeur, toutes deux sous forme de chaînes.
: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)