C#'ta IronPDF ile Çerezleri Kullanma

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:

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

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

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:

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

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.