IRONSOFTWAREHOME

Wie man Cookies mit IronPDF in C#35 verwendet

Curtis Chau
Curtis Chau
Updated: 24. April 2026

IronPDF verwendet die RequestContext Eigenschaft und die ApplyCookies Methode, um Cookies in die PDF-Erstellung zu integrieren, wobei Sitzungsinformationen und Benutzerauthentifizierung während der HTML-zu-PDF-Konvertierungen beibehalten werden.

Cookies sind kleine Datenelemente, die Websites auf den Geräten der Benutzer speichern. Sie verwalten Sitzungen, verfolgen das Benutzerverhalten und speichern Präferenzen. Datenschutzbestimmungen wie GDPR und CCPA haben die Cookie-Verwaltung stärker in den Fokus gerückt und die Browser dazu veranlasst, den Nutzern mehr Kontrolle über die Cookie-Verwaltung zu bieten.

Bei der Verwendung der Chrome-Rendering-Engine von IronPDF werden während des HTML-zu-PDF-Konvertierungsprozesses Cookies gespeichert. Dies ist wichtig für die Darstellung von Seiten, die TLS-Website-Authentifizierung und Systemanmeldungen oder benutzerspezifische Einstellungen erfordern.

Schnellstart: Cookies in IronPDF verwenden

Integrieren Sie Cookies in Ihren PDF-Rendering-Prozess mit IronPDF. Dieser Leitfaden zeigt die Verwendung der IronPdf API zur Verwaltung von Cookies während der HTML-zu-PDF-Konvertierungen. Verwenden Sie Standard- oder benutzerdefinierte Cookies mithilfe der RequestContext Eigenschaft und der ApplyCookies Methode mit minimalem Code.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    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");
    C#
  3. 3Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion
    arrow pointer

Wie wende ich Cookies beim PDF-Rendering an?

Was ist die RequestContext Eigenschaft?

Setzen Sie die RequestContext Eigenschaft auf RequestContexts.Global, bevor Sie Cookies anwenden. Erstellen Sie die ChromeHttpLoginCredentials Klasse und übergeben Sie sie an die ApplyCookies Methode. Der Renderer rendert dann den HTML-Inhalt mit Cookies in PDF.

Die RequestContext Eigenschaft arbeitet mit HTTP-Anforderungs-Headern und Authentifizierung. Sie bestimmt die gemeinsame Nutzung von Cookies zwischen Rendering-Sitzungen, was für Anwendungen, die den Sitzungsstatus über mehrere PDF-Generationen hinweg beibehalten, entscheidend ist.

Wie verwende ich die ApplyCookies Methode?

Cookies mit IronPDF anwenden:

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

Dieser Ansatz funktioniert bei der Konvertierung von ASPX-Seiten in PDF, die eine Authentifizierung erfordern, oder bei ASP.NET MVC-Anwendungen.

Welches RequestContext sollte ich wählen?

RequestContexts Enum definiert Browser-Anforderungs-Kontexte, die Beziehungen zwischen den Renderings herstellen. Sie verwaltet Cookies und Benutzereinstellungen.

  • Isolated: Erstellt neue, isolierte Anforderungskontexte. Verhindert, dass aktuelle Renderings von früheren Renderings beeinflusst werden. Ideal für Multi-Thread-PDF-Erzeugung.
  • Global: Verwendet einen globalen gemeinsamen Anforderungskontext zwischen allen Renderings. Behält den Browserstatus zwischen den Renderings bei. Perfekt für die Beibehaltung von Sitzungsdaten bei PDF-Vorgängen.
  • Auto: Voreinstellung ist IronPdf.Rendering.RequestContexts.Isolated. Wechselt zu IronPdf.Rendering.RequestContexts.Global, wenn IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) aufgerufen wurde.

Beim Implementieren von Cookies in Blazor Server-Anwendungen wählen Sie das geeignete RequestContext, um den korrekten Sitzungszustand zwischen serverseitigen Renderings zu erhalten.


Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

Wie wende ich benutzerdefinierte Cookies an?

Was sind benutzerdefinierte Cookies in IronPDF?

CustomCookies erfordert das Setzen der CustomCookies Eigenschaft. Diese Eigenschaft akzeptiert String-Schlüssel-Wert-Paar-Wörterbücher. Benutzerdefinierte Cookies handhaben komplexe Authentifizierungssysteme oder übermitteln Daten auf Anwendungsebene während des Renderings.

Benutzerdefinierte Cookies unterscheiden sich von Standard-HTTP-Cookies, da sie eine beliebige Definition von Schlüssel-Wert-Paaren zulassen. Diese Flexibilität eignet sich für moderne Webanwendungen, die JWT-Tokens, Sitzungs-IDs oder benutzerdefinierte Authentifizierungsmechanismen verwenden.

Wie implementiere ich benutzerdefinierte Cookies?

Anwenden von benutzerdefinierten Cookies mit IronPDF:

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

Dieser Ansatz eignet sich für JavaScript-lastige Websites, die auf Cookies für die Statusverwaltung angewiesen sind oder angepasste Protokollierungslösungen implementieren.

Wann sollte ich benutzerdefinierte Cookies gegenüber Standard-Cookies verwenden?

Benutzerdefinierte Cookies behandeln spezifische Sitzungsdaten oder Authentifizierungs-Token, die nicht durch Standard-HTTP-Anmeldeinformationen verwaltet werden. Verwenden Sie sie mit benutzerdefinierten Authentifizierungssystemen oder um Benutzereinstellungen während der PDF-Generierung beizubehalten.

Standard-Cookies (über die ApplyCookies Methode) sind geeignet für:

  • Grundlegende HTTP-Authentifizierung
  • Windows-Authentifizierungsumgebungen
  • Einfache Sitzungsverwaltung

Benutzerdefinierte Cookies excel für:

  • JWT-Token-basierte Authentifizierung
  • Komplexe Sitzungsverwaltung mit mehreren Parametern
  • Authentifizierungsanbieter von Drittanbietern (OAuth, SAML)
  • Pflege von Benutzerpräferenzen und Einstellungen
  • Anforderungen an Analytik und Tracking

Was sind häufige Probleme bei der Implementierung von Cookies?

Häufige Probleme umfassen Cookies, die zwischen Renderings im Isolated Kontext nicht erhalten bleiben, Authentifizierungsfehler aufgrund falscher Cookie-Werte und Timing-Probleme, bei denen Cookies vor der PDF-Erstellung ablaufen. Überprüfen Sie die Gültigkeit der Cookies und ziehen Sie den Global Kontext für beständige Sitzungen in Betracht.

Tipps zur Fehlerbehebung:

  1. Cookie-Ablauf: Überprüfen Sie, dass Cookies nicht abgelaufen sind. Implementierung einer Aktualisierungslogik für kurzlebige Token.
  2. Domäneneinschränkungen: Stellen Sie sicher, dass die Cookie-Domänen mit der gerenderten URL übereinstimmen.
  3. Sichere Cookies: Konfigurieren Sie sichere Cookies richtig, wenn Sie HTTPS-URLs wiedergeben.
  4. SameSite-Richtlinien: Berücksichtigen Sie die SameSite-Cookie-Richtlinien des Browsers, die Cross-Origin-Anfragen betreffen.

Für fortgeschrittene Authentifizierungs- und Cookie-Szenarien siehe die Dokumentation der Wiedergabeoptionen, die alle verfügbaren Einstellungen zur Anpassung der PDF-Erzeugung enthält.

Häufig gestellte Fragen

Wie wende ich Cookies beim Rendern von HTML in PDF an?

Um Cookies mit IronPDF anzuwenden, setzen Sie die Eigenschaft RequestContext auf RequestContexts.Global im ChromePdfRenderer und verwenden Sie dann die Methode ApplyCookies mit ChromeHttpLoginCredentials. Dadurch wird sichergestellt, dass Cookies während des HTML-zu-PDF-Konvertierungsprozesses ordnungsgemäß übertragen werden.

Wofür wird die Eigenschaft RequestContext verwendet?

Die Eigenschaft RequestContext in IronPDF bestimmt, wie Cookies zwischen Rendering-Sitzungen ausgetauscht werden. Sie arbeitet mit HTTP-Anforderungs-Headern und Authentifizierung und ist damit entscheidend für Anwendungen, die den Sitzungsstatus über mehrere PDF-Generationen hinweg beibehalten müssen.

Kann ich beim PDF-Rendering benutzerdefinierte Cookies hinzufügen?

Ja, IronPDF erlaubt benutzerdefinierte Cookies über die Eigenschaft CustomCookies. Erstellen Sie einfach ein Dictionary mit Ihren Cookie-Schlüssel-Wert-Paaren und weisen Sie es der Eigenschaft RenderingOptions.CustomCookies des ChromePdfRenderers zu.

Wie rendere ich eine Cookie-geschützte Seite in PDF?

Verwenden Sie den ChromePdfRenderer von IronPDF, wobei der RequestContext auf Global eingestellt ist, und fügen Sie Ihre Cookies über die Eigenschaft CustomCookies hinzu. Rufen Sie dann RenderUrlAsPdf() mit Ihrer geschützten URL auf. Der Renderer nimmt die Cookies in die Anfrage auf und ermöglicht den Zugriff auf geschützte Inhalte.

Welche Arten der Authentifizierung können Cookies beim PDF-Rendering verarbeiten?

Die Cookie-Integration von IronPDF unterstützt verschiedene Authentifizierungsszenarien, darunter TLS-Website-Authentifizierung, Systemanmeldungen und sitzungsbasierte Authentifizierung. Dies ist besonders nützlich bei der Konvertierung von ASPX-Seiten oder ASP.NET MVC-Anwendungen, die eine Benutzerauthentifizierung erfordern.

Warum sind Cookies bei der Konvertierung von HTML in PDF wichtig?

Cookies halten den Status während des Konvertierungsprozesses von HTML in PDF mit der Chrome-Rendering-Engine von IronPDF aufrecht. Sie sind unerlässlich für das Rendern von Seiten, die eine Authentifizierung erfordern, für die Beibehaltung benutzerspezifischer Einstellungen und für die Aufrechterhaltung von Sitzungsinformationen während der Konvertierung.

How does IronPDF ensure security with secure cookies?

Properly configure secure cookies by ensuring they are only sent over HTTPS and match the required security policies when rendering PDFs.

Can IronPDF manage cookies for JavaScript-heavy sites?

Yes, IronPDF can manage cookies for JavaScript-heavy sites that rely on cookies for state management by using custom cookies or specific rendering options.

How can IronPDF be used with Blazor Server applications?

When implementing cookies in Blazor Server applications, choose the appropriate `RequestContext` to maintain proper session state between server-side renders.

What should I consider when using IronPDF's `ApplyCookies` method?

Ensure proper setup of the `RequestContext` and use valid HTTP credentials, verifying against your application's authentication requirements before applying cookies.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...
Weiterlesen

Bereit anzufangen?

Nuget Downloads 21,105,021Version:2026.9gerade veröffentlicht

Holen Sie sich Ihre KOSTENLOSE

30-Tage-Testlizenz sofort.

bullet_checkedKeine Kreditkarte oder Kontoerstellung erforderlich
bullet_testTesten Sie in der Produktion
ohne Wasserzeichen
bullet_calendar30 Tage voll
funktionsfähiges Produkt
bullet_support24/5 technischer
Support während der Testphase
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

OR
bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Buchen Sie Ihre kostenlose Live-Demo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Kundenlogos von Iron Software
Erhalten Sie Ihre unverbindliche Beratung
Füllen Sie das Formular unten aus oder senden Sie eine E-Mail an sales@ironsoftware.com
Ihre Daten werden immer vertraulich behandelt.
Von Millionen von Ingenieur*innen weltweit vertraut
Kundenlogos von Iron Software
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $