How to use Cookies with IronPDF

Beispiel zum Anwenden von Cookies

Bevor Sie die Methode zum Anwenden von Cookies verwenden, setzen Sie die RequestContext-Eigenschaft auf RequestContexts.Global. Erstellen Sie dann die ChromeHttpLoginCredentials-Klasse und übergeben Sie sie der ApplyCookies-Methode. Der Renderer ist jetzt bereit, HTML-Inhalte mit Cookies in PDFs zu rendern.

Hier ist ein Beispiel zur Anwendung von Cookies mit 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)

RequestContexts Enum: Dieses Enum definiert Browser-Anfragekontexte, die verwendet werden, um Beziehungen zwischen einzelnen Renderings herzustellen. Es ist entscheidend für die Verwaltung von Cookies und Benutzereinstellungen.

• Isolated: Erstellt einen neuen Anfragekontext, der von vorherigen oder zukünftigen Renderings isoliert ist. Empfohlen, um sicherzustellen, dass das aktuelle Rendering nicht von vorherigen Renderings beeinflusst wird.
• Global: Verwendet den globalen Anfragekontext, der zwischen allen Renderings geteilt wird. In manchen Fällen nützlich, um bestimmte Browserzustände zwischen Renderings beizubehalten.
• Auto: Standardmäßig IronPdf.Rendering.RequestContexts.Isolated, wechselt jedoch zu IronPdf.Rendering.RequestContexts.Global, wenn der Benutzer jemals IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) aufgerufen hat.

Beispiel zum Anwenden benutzerdefinierter Cookies

Die Verwendung benutzerdefinierter Cookies in einer Anfrage erfordert das Setzen der CustomCookies-Eigenschaft. Diese Eigenschaft akzeptiert ein Wörterbuch von Schlüssel-Wert-Paaren, beides als Zeichenfolgen.

Hier ist ein Beispiel zur Anwendung benutzerdefinierter Cookies mit 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)