C#'ta IronPDF ile Çerezleri Kullanma

Curtis Chau

Updated: 24 Nisan 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

IronPDF, HTML'den PDF'e dönüştürmeler sırasında oturum bilgilerini ve kullanıcı kimlik doğrulamasını koruyarak, tanımlama bilgilerini PDF oluşturma işlemine entegre etmek için RequestContext özelliği ve ApplyCookies yöntemini kullanır.

Çerezler, web sitelerinin kullanıcı cihazlarında depoladığı küçük veri parçalarıdır. Oturumları yönetir, kullanıcı davranışını izler ve tercihleri saklarlar. GDPR ve CCPA gibi gizlilik düzenlemeleri, çerez yönetimine odaklanmayı artırarak tarayıcıların kullanıcılara çerez işleme üzerinde daha büyük kontrol sağlamasına neden oldu.

IronPDF'nin Chrome rendering motorunu kullanırken, çerezler HTML'den PDF'ye dönüşüm süreci sırasında durumu korur. Bu, TLS web sitesi kimlik doğrulaması ve sistem girişleri veya kullanıcıya özgü tercihleri gerektiren sayfalar render edildiğinde çok önemlidir.

IronPDF ile PDF render etme sürecine çerezleri entegre edin. Bu kılavuz, HTML'den PDF'e dönüştürmeler sırasında tanımlama bilgilerini yönetmek için IronPdf API'sini kullanmayı gösterir. Minimal kod ile RequestContext özelliği ve ApplyCookies yöntemi kullanarak standart veya özel tanımlama bilgilerini uygulayın.

PDF Renderine Çerezleri Nasıl Uygularım?

RequestContext Özelliği Nedir?

Tanımlama bilgilerini uygulamadan önce RequestContext özelliğini RequestContexts.Global olarak ayarlayın. ChromeHttpLoginCredentials sınıfını oluşturun ve ApplyCookies yöntemine geçirin. Renderleyici daha sonra HTML içeriğini çerezlerle PDF'e dönüştürür.

RequestContext özelliği HTTP isteği başlıkları ve kimlik doğrulama ile çalışır. Bu, birden fazla PDF oluşturma işlemi arasında oturum durumunu koruyan uygulamalar için çerez paylaşımını belirler.

ApplyCookies Yöntemini Nasıl Kullanırım?

IronPDF kullanarak çerezleri uygulayın:

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

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)

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)

Bu yaklaşım, kimlik doğrulaması gerektiren ASPX sayfalarını PDF'ye dönüştürme veya ASP.NET MVC uygulamalarıyla çalışırken etkilidir.

Hangi RequestContext Seçmeliyim?

RequestContexts Enum, render'lar arasında ilişkiler kurarak tarayıcı isteği bağlamlarını tanımlar. Çerezleri ve kullanıcı tercihlerini yönetir.

• Isolated: Yeni, izole edilmiş istek bağlamları oluşturur. Mevcut renderların önceki renderlar tarafından etkilenmesini önler. Çok iş parçacıklı PDF oluşturma için idealdir.
• Global: Tüm render'lar arasında paylaşılan global istek bağlamını kullanır. Renderlar arasındaki tarayıcı durumlarını kalıcı hale getirir. PDF işlemleri arasında oturum verilerini korumak için mükemmeldir.
• Auto: IronPdf.Rendering.RequestContexts.Isolated varsayılan olarak kabul edilir. IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) çağrıldıysa IronPdf.Rendering.RequestContexts.Global'ye geçer.

Blazor Sunucu uygulamalarında tanımlama bilgilerini uygularken, sunucu tarafı render'lar arasında doğru oturum durumunu korumak için uygun RequestContext'yi seçin.

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Özel Çerezleri Nasıl Uygularım?

IronPDF'deki Özel Çerezler Nelerdir?

CustomCookies, CustomCookies özelliğinin ayarlanmasını gerektirir. Bu özellik, string anahtar-değer çiftleri sözlükleri kabul eder. Özel çerezler, render sırasında karmaşık kimlik doğrulama sistemlerini yönetir veya uygulama düzeyinde veri iletir.

Özel çerezler, herhangi bir anahtar-değer çiftine izin vererek standart HTTP çerezlerinden farklıdır. Bu esneklik, JWT tokenları, oturum kimlikleri veya özel kimlik doğrulama mekanizmaları kullanan modern web uygulamalarına uygun hale gelir.

Özel Çerezler Nasıl Uygulanır?

IronPDF kullanarak özel çerezleri uygulayın:

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

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)

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)

Bu yaklaşım, durum yönetimi için çerezlere dayanan JavaScript yoğun siteler veya özel günlüğe kaydetme çözümleri uygularken uygundur.

Özel Çerezleri Ne Zaman Kullanmalıyım?

Özel çerezler, standart HTTP kimlik bilgileri tarafından yönetilmeyen belirli oturum verileri veya kimlik doğrulama tokenlarını yönetir. Özel kimlik doğrulama sistemleriyle veya PDF oluşturma sırasında kullanıcı tercihlerini korumak için kullanın.

Standart tanımlama bilgileri (ApplyCookies yöntemi ile) uygundur:

• Temel HTTP kimlik doğrulaması
• Windows kimlik doğrulama ortamları
• Basit oturum yönetimi

Özel çerezler ise şunlar için ustadır:

• JWT token tabanlı kimlik doğrulama
• Birden çok parametreye sahip karmaşık oturum yönetimi
• Üçüncü taraf kimlik doğrulama sağlayıcıları (OAuth, SAML)
• Kullanıcı tercihleri ve ayarlarının korunması
• Analitik ve izleme gereksinimleri

Çerez Uygulaması ile İlgili Yaygın Sorunlar Nelerdir?

Yaygın sorunlar arasında Isolated bağlamını kullanarak render'lar arasında tanımlama bilgilerinin korunmaması, yanlış tanımlama bilgisi değerlerinden kaynaklanan kimlik doğrulama hataları ve PDF oluşturulmadan önce tanımlama bilgilerinin süresinin dolduğu zamanlama sorunları bulunur. Tanımlama bilgisinin geçerliliğini doğrulayın ve kalıcı oturumlar için Global bağlamını değerlendirin.

Sorun giderme ipuçları:

1. Çerez Süresi Doldu: Çerezlerin süresinin dolmadığını doğrulayın. Kısa ömürlü tokenlar için yenileme mantığı uygulayın.
2. Alan Sınırlamaları: Çerez alanlarının render edilen URL ile eşleştiğinden emin olun.
3. Güvenli Çerezler: HTTPS URL'leri render edilirken güvenli çerezleri doğru bir şekilde yapılandırın.
4. SameSite Politikaları: Tarayıcı SameSite çerez politikalarını çapraz kaynak isteklerini etkileyebilecek şekilde düşünün.

Gelişmiş kimlik doğrulama ve çerez senaryoları için, mevcut tüm PDF oluşturma özelleştirme ayarlarını kapsayan rendering options documentatione göz atın.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...

Daha Fazla Oku