Azure Function ile IronPDF Kullanarak HTML'den PDF'ye C# Nasıl Kullanılır
IronPDF, Azure platformlarında MVC web siteleri ve Azure Fonksiyonları dahil PDF belgeleri oluşturabilir, manipüle edebilir ve okuyabilir. Bu kılavuz, uygun yapılandırma ve üretim ortamları için optimizasyon ile Azure Fonksiyonlarında HTML'den PDF'ye dönüştürme işlemini nasıl uygulayacağınızı gösterir.
Azure İşlevlerini Docker Container içinde çalıştırıyorsanız, lütfen yerine bu Azure Docker Linux Eğiticisine başvurun.
Hızlı Başlangıç: IronPDF ile Azure'da HTML'den PDF'ye DönüştürmeIronPDF kullanarak Azure uygulamalarınızda HTML'den PDF'ye dönüştürmeye başlayın. Bu hızlı kılavuz, IronPDF'in API yöntemlerini kullanarak bir URL'yi PDF belgesi olarak nasıl işleneceğini gösterir. Bu örnek, IronPDF'in Azure çözümlerine PDF yeteneklerini entegre etmedeki basitliğini vurgular. Örneği takip ederek biçimlendirmeyi kaybetmeden PDF'ler oluşturun ve Azure projenizi hızlıca çalışır hale getirin.
-
1Install IronPDF with NuGet Package Manager
-
2Bu kod parçacığını kopyalayın ve çalıştırın.
var pdf = new IronPdf.ChromePdfRenderer() .RenderHtmlAsPdf("<h1>Hello Azure!</h1>") .SaveAs("output-azure.pdf");C# -
3Canlı ortamınızda test için dağıtım yapın
Ücretsiz deneme ile bugün projenizde IronPDF kullanmaya başlayın
Asgari İş Akışı (5 adım)
- Azure'da PDF oluşturmak için C# kütüphanesini yükleyin
- Azure Temel B1 barındırma katmanını veya üstünü seçin
- Yayınlarken
paket dosyasından çalıştırseçeneğini işaretsiz bırakın - Önerilen konfigürasyon talimatlarını izleyin
- Azure'da PDF oluşturucu oluşturmak için kod örneğini kullanın
Nasıl Rehberi
Projemi Nasıl Ayarlayabilirim?
Hangi IronPDF Paketini Yüklemeliyim?
İlk adım, IronPDF'i NuGet kullanarak yüklemektir:
- Windows tabanlı Azure Functions'da
IronPdfpaketini kullanın - Windows için NuGet IronPDF paketi - Linux tabanlı Azure Functions'da
IronPdf.Linuxpaketini kullanın - Linux için NuGet IronPDF paketi
Alternatif olarak, Azure için doğrudan IronPDF indirme paketi bağlantısını kullanarak .dll dosyasını manuel olarak yükleyin.
Daha gelişmiş yükleme seçenekleri için kapsamlı NuGet Paketleri kılavuzumuza göz atın.
Hangi Azure Seçeneklerini Yapılandırmalıyım?
Hangi Azure Hosting Katmanını Seçmeliyim?
Azure Basic B1, işleme ihtiyaçları için gereken minimum hosting seviyesidir. Eğer yüksek aktarım hızlı bir sistem oluşturuyorsanız, bu yükseltilmesi gerekebilir. B1 katmanı, IronPDF'in HTML'den PDF'e dönüştürme motorunu destekleyen Chrome PDF Render Motoru için yeterli kaynaklar sağlar.
"Paketten Çalıştır" Seçeneğini Neden İşaretlememeliyim?
Azure Functions uygulamanızı yayınlarken, Run from package file SEÇİLİ DEĞİL olduğundan emin olun. Bu seçenek, çalıştırma sırasında IronPDF'in gerekli çalışma zamanı bağımlılıklarını çıkartmasını engeller.
.NET 6 İçin Nasıl Yapılandırırım?
Microsoft yakın zamanda, birçok eski API'yi bozan görüntü kütüphanelerini .NET 6+'dan kaldırdı. Bu nedenle, bu eski API çağrılarına hala izin vermek için projenizi yapılandırmanız gereklidir.
-
Linux'ta, makinede
libgdipluskurulu olduğunu sağlamak içinInstallation.LinuxAndDockerDependenciesAutoConfig=true;ayarlayın -
.NET 6 projeniz için
.csprojdosyasına aşağıdakileri ekleyin:<GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>XML -
Projenizde
runtimeconfig.template.jsonadında bir dosya oluşturun ve aşağıdakilerle doldurun:{ "configProperties": { "System.Drawing.EnableUnixSupport": true } }JSON -
Son olarak,
System.Drawingiçin Unix desteğini etkinleştirmek üzere programınızın başına aşağıdaki satırı ekleyin:System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", True)
Ne Zaman Azure'da Docker Kullanmalıyım?
Azure'da kontrol kazanmanın bir yolu, SVG yazı tipi erişimi ve performansı kontrol kabiliyetini sağlamak için IronPDF uygulamalarını ve Fonksiyonlarını Docker Container'dan kullanmaktır. Bu yaklaşım, çalışma zamanı ortamı üzerinde daha iyi kontrol sağlar ve platforma özgü birçok sınırlamayı ortadan kaldırır.
Linux ve Windows örnekleri için kapsamlı bir IronPDF Azure Docker öğreticisi hazırız ve okunması önerilmektedir.
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.
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.
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.
Azure Function Kodu Nasıl Görünür?
Bu örnek, günlük kayıtlarını yerleşik Azure günlüğüne otomatik olarak (bkz. ILogger log) çıkarır. Detaylı günlük yapılandırmaları için, Özelleştirilmiş Günlük tutma kılavuzumuza başvurun.
[FunctionName("PrintPdf")]
public static async Task<IActionResult> Run(
[HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
ILogger log, ExecutionContext context)
{
log.LogInformation("Entered PrintPdf API function...");
// Apply license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
// Configure logging
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.Custom;
IronPdf.Logging.Logger.CustomLogger = log;
IronPdf.Logging.Logger.EnableDebugging = false;
// Configure IronPdf settings
Installation.LinuxAndDockerDependenciesAutoConfig = false;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
try
{
log.LogInformation("About to render pdf...");
// Create a renderer and render the URL as PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://www.google.com/");
log.LogInformation("Finished rendering pdf...");
// Return the rendered PDF as a file download
return new FileContentResult(pdf.BinaryData, "application/pdf") { FileDownloadName = "google.pdf" };
}
catch (Exception e)
{
log.LogError(e, "Error while rendering pdf");
}
return new OkObjectResult("OK");
}<FunctionName("PrintPdf")>
Public Shared Async Function Run(
<HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route:=Nothing)> req As HttpRequest,
log As ILogger, context As ExecutionContext) As Task(Of IActionResult)
log.LogInformation("Entered PrintPdf API function...")
' Apply license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
' Configure logging
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.Custom
IronPdf.Logging.Logger.CustomLogger = log
IronPdf.Logging.Logger.EnableDebugging = False
' Configure IronPdf settings
Installation.LinuxAndDockerDependenciesAutoConfig = False
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Try
log.LogInformation("About to render pdf...")
' Create a renderer and render the URL as PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://www.google.com/")
log.LogInformation("Finished rendering pdf...")
' Return the rendered PDF as a file download
Return New FileContentResult(pdf.BinaryData, "application/pdf") With {.FileDownloadName = "google.pdf"}
Catch e As Exception
log.LogError(e, "Error while rendering pdf")
End Try
Return New OkObjectResult("OK")
End FunctionGelişmiş HTML Dizesi İşleme Örneği
CSS stillendirme ile özel HTML içeren daha karmaşık senaryolar için, HTML Dizesinden PDF'ye yeteneklerini kullanabilirsiniz:
[FunctionName("RenderHtmlWithCss")]
public static async Task<IActionResult> RenderHtmlWithCss(
[HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
ILogger log)
{
log.LogInformation("Processing HTML to PDF request");
// Read HTML content from request body
string htmlContent = await new StreamReader(req.Body).ReadToEndAsync();
// Configure renderer with custom options
var renderer = new ChromePdfRenderer()
{
RenderingOptions = new ChromePdfRenderOptions()
{
MarginTop = 20,
MarginBottom = 20,
MarginLeft = 10,
MarginRight = 10,
CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print,
PrintHtmlBackgrounds = true,
CreatePdfFormsFromHtml = true
}
};
try
{
// Add custom CSS
string styledHtml = $@"
<html>
<head>
<style>
body {{font-family: Arial, sans-serif; padding: 20px;}}
h1 {{color: #2c3e50;}}
.highlight {{background-color: #f1c40f; padding: 5px;}}
</style>
</head>
<body>
{htmlContent}
</body>
</html>";
var pdf = renderer.RenderHtmlAsPdf(styledHtml);
return new FileContentResult(pdf.BinaryData, "application/pdf")
{
FileDownloadName = "styled-document.pdf"
};
}
catch (Exception ex)
{
log.LogError(ex, "Failed to render HTML to PDF");
return new BadRequestObjectResult("Error processing HTML content");
}
}Azure Fonksiyonlarınızda lisans yönetimi için, Lisans Anahtarları Kullanımı dokümantasyonumuza başvurun.
Bilinen Sorunlar Nelerdir?
SVG Fontları Neden Paylaşılan Hosting Planlarında Render Edilmez?
Azure hosting platformu genel bakış, ucuz paylaşımlı web uygulama katmanlarında Google Fonts gibi sunucu yüklemelerini desteklemez. Bu, Windows GDI+ grafik nesnelerine erişimi kısıtlayan güvenlik kısıtlamalarından kaynaklanmaktadır.
IronPDF için Windows veya Linux Docker Container rehberimizi veya en iyi yazı tipi işleme gereksiniminiz olduğunda belki Azure üzerinde bir VPS kullanmayı öneriyoruz.
Neden Azure Ücretsiz Katman Hosting Yavaştır?
Azure ücretsiz ve paylaşılan katmanlar ile tüketim planı, PDF oluşturma için uygun değildir. Kendi kullandığınız Azure B1 barındırma/Premium planı öneririz. HTML to PDF işlemi herhangi bir bilgisayar için önemli bir 'çalışma' - kendi makinenizde bir web sayfası açıp işlemekle benzer. Gerçek bir tarayıcı motoru kullanılır, bu yüzden benzer güçteki bir masaüstü makineyle benzer işlem sürelerini beklememiz ve buna göre tedarikte bulunmamız gerekiyor.
Azure Fonksiyonlarını Nasıl Yerel Olarak Hata Ayıklarım?
Yerel geliştirme ve test için, Yerel Makinede IronPDF ile Azure Fonksiyonları Projesini Hata Ayıklama kılavuzumuza başvurun. Bu, Azure'a dağıtmadan önce sorunları belirlemenize ve çözmenize yardımcı olur.
Azure Günlüklerini Nerede Bulabilirim?
PDF üretim sorunlarını giderirken, Azure günlükleri paha biçilmezdir. IronPDF işlemlerine özgü günlükleri erişmek ve yorumlamak için Azure Günlük Dosyaları kılavuzumuza göz atın.
Bir Teknik Destek Talebi Nasıl Oluşturabilirim?
Talep bileti oluşturmak için, IronPDF için Teknik Destek Talebi Nasıl Hazırlanır kılavuzumuza başvurun.
Üretim için En İyi Uygulamalar
- Her zaman uygun barındırma katmanlarını kullanın - güvenilir performans için
B1veya daha iyi - Loglamayı doğru yapılandırın - Üretim izleme için Azure Uygulama içgörülerini kullanın
- Hataları zarifçe yönetin - Geçici hatalar için tekrar deneme mantığını uygulayın
- HTML içeriğini optimize edin - Dış kaynakları minimize edin ve mümkün olduğunda base64 kodlu resimleri kullanın
- İyice test edin - Azure dağıtımından önce yerel olarak PDF oluşturmayı doğrulayın
- Kaynak kullanımını izleyin - Ölçeklemeyi uygun hale getirmek için bellek ve CPU tüketimini takip edin
Sıkça Sorulan Sorular
PDF oluşturma için gereken minimum Azure barındırma katmanı nedir?
IronPDF, PDF işleme ihtiyaçları için gereken minimum barındırma seviyesi olarak Azure Basic B1 katmanı gerektirir. B1 katmanı, IronPDF'in HTML'den PDF'ye dönüştürme yeteneklerini destekleyen Chrome PDF İşleme Motoru için yeterli kaynak sağlar.
Windows tabanlı Azure İşlevleri için hangi paketi yüklemeliyim?
Windows tabanlı Azure İşlevleri için, NuGet'ten IronPdf paketini yükleyin. Bu paket, Windows ortamları için optimize edilmiştir ve Chrome işleme motoru ile tam PDF oluşturma yetenekleri sağlar.
Azure İşlevlerinde HTML'yi nasıl PDF'ye dönüştürürüm?
IronPDF'in ChromePdfRenderer'ını kullanarak, HTML'yi PDF'ye dönüştürmek için tek satırlık kod ile yapabilirsiniz. Sadece bir örnek oluşturun ve HTML içeriğinizle RenderHtmlAsPdf() çağrısı yapın, ardından sonuç PDF dosyasını kaydedin.
Doğru Uygulama Hizmeti Planı'nı seçmezsem ne olur?
Uygulama hizmet planı türünü seçmemek, IronPDF'in PDF belgelerini işleyememesine neden olabilir. Azure barındırma ortamının doğru yapılandırılması, PDF işleme motorunun düzgün çalışabilmesi için elzemdir.
'Paket dosyasından çalıştır' seçeneği yayınlarken neden işaretlenmemeli?
Azure İşlevleri uygulamanızı yayınlarken 'Paket dosyasından çalıştır' seçeneği işaretli olmamalıdır, böylece IronPDF, Azure ortamındaki işleme bileşenlerine ve bağımlılıklarına doğru erişip bunları kullanabilir.
Linux tabanlı Azure İşlevlerini PDF oluşturma için kullanabilir miyim?
Evet, Linux tabanlı Azure İşlevleri için, NuGet'ten IronPdf.Linux paketini kullanın. Bu paket, Linux ortamları için özel olarak optimize edilmiştir ve aynı PDF oluşturma yeteneklerini sağlar.
PDF oluşturma için daha yüksek throughput ihtiyacım olursa ne yapmalıyım?
Yüksek throughput sistemler için B1 katmanının ötesine geçmeniz gerekebilir. IronPDF, Azure kaynaklarınızla birlikte ölçeklenir, böylece daha yüksek performans katmanlarını seçerek artan PDF oluşturma taleplerini karşılamanıza olanak tanır.
What are the best practices for using IronPDF in production on Azure?
Best practices include using appropriate hosting tiers, configuring logging with Azure Application Insights, handling exceptions, optimizing HTML content, and rigorous testing before deployment.
When should I consider using Docker with IronPDF on Azure?
Consider using Docker for better control over the runtime environment and to eliminate platform-specific limitations, especially for SVG font access or performance control.
How can I access Azure logs for troubleshooting IronPDF operations?
Refer to our Azure Log Files guide for instructions on accessing and interpreting logs to troubleshoot PDF generation issues specific to IronPDF operations.
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.
