C#'da Bir E-posta Eki Olarak PDF Dosyası Nasıl Gönderilir

Gerekli Paketleri Nasıl Yüklersiniz?

Bu iş akışını güçlendiren iki paket vardır: bir PDF oluşturma kitaplığı ve bir e-posta gönderme kitaplığı. Hem Visual Studio'daki Paket Yoneticisi Konsolundan hem de .NET CLI aracılığıyla yukleyin.

Install-Package IronPdf
dotnet add package IronPdf
Install-Package MailKit
dotnet add package MailKit

Install-Package IronPdf
dotnet add package IronPdf
Install-Package MailKit
dotnet add package MailKit

IronPDF, HTML, CSS ve JavaScript'i pikselle mükemmel PDF dokümanlarina dönüştüren Chromium tabanli bir render motoru getiriyor. Windows, Linux ve macOS'ta calisir, bu da ayni kodun bir ASP.NET Core web API'sinde, bir arka plan servisinde veya bir Azure Fonksiyonunda calistigi anlamına gelir. MailKit, Microsoft'un yeni butun .NET e-posta geliştirmeleri icin tavsiye ettigi kutuphanedir -- SMTP, IMAP, POP3, OAuth 2.0 ve tam MIME olusuturmeyi destekler. MailKit kaynak ve dokümantasyon GitHub'da mevcuttur.

Memory'de PDF Dokümani Nasıl Oluşturursunuz?

ChromePdfRenderer sınıfı, HTML'den PDF'ye dönüşüm için giriş noktasıdır. RenderHtmlAsPdf'a bir HTML dizesi geçin ve tamamen hafızada yaşayan bir PdfDocument nesnesi elde edin. Ham baytları BinaryData özelliği aracılığıyla erişin -- bu bayt dizisi e-posta eki API'lerinin tam da beklediği şeydir.

using IronPdf;

var renderer = new ChromePdfRenderer();

string htmlContent = """
    <h1>Order Confirmation</h1>
    <p>Thank you for your purchase.</p>
    <table>
        <tr><th>Item</th><th>Qty</th><th>Price</th></tr>
        <tr><td>Widget A</td><td>2</td><td>$19.99</td></tr>
        <tr><td>Widget B</td><td>1</td><td>$59.99</td></tr>
    </table>
    <p><strong>Order Total: $99.97</strong></p>
    """;

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

// pdf.BinaryData holds the complete PDF as a byte array
byte[] pdfBytes = pdf.BinaryData;
Console.WriteLine($"PDF generated: {pdfBytes.Length} bytes");

using IronPdf;

var renderer = new ChromePdfRenderer();

string htmlContent = """
    <h1>Order Confirmation</h1>
    <p>Thank you for your purchase.</p>
    <table>
        <tr><th>Item</th><th>Qty</th><th>Price</th></tr>
        <tr><td>Widget A</td><td>2</td><td>$19.99</td></tr>
        <tr><td>Widget B</td><td>1</td><td>$59.99</td></tr>
    </table>
    <p><strong>Order Total: $99.97</strong></p>
    """;

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

// pdf.BinaryData holds the complete PDF as a byte array
byte[] pdfBytes = pdf.BinaryData;
Console.WriteLine($"PDF generated: {pdfBytes.Length} bytes");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

Dim htmlContent As String = "
    <h1>Order Confirmation</h1>
    <p>Thank you for your purchase.</p>
    <table>
        <tr><th>Item</th><th>Qty</th><th>Price</th></tr>
        <tr><td>Widget A</td><td>2</td><td>$19.99</td></tr>
        <tr><td>Widget B</td><td>1</td><td>$59.99</td></tr>
    </table>
    <p><strong>Order Total: $99.97</strong></p>
    "

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

' pdf.BinaryData holds the complete PDF as a byte array
Dim pdfBytes As Byte() = pdf.BinaryData
Console.WriteLine($"PDF generated: {pdfBytes.Length} bytes")

RenderHtmlAsPdf metodu, HTML'yi Google Chrome'u çalıştıran aynı Chromium motorunu kullanarak işler, bu nedenle tablolar, CSS Grid, Flexbox ve gömülü fontlar bir tarayıcıda olduğu gibi tam olarak işlenir. Sonuç, BinaryData özelliğinin tam PDF ikili verisini herhangi bir disk okuma ve yazma olmadan döndürdüğü bir PdfDocument'dir. Dış resimler veya stil dosyalarını çeken belgeler için, göreceli kaynak URL'lerini IronPDF'in nasıl çözeceğini söylemek amacıyla, isteğe bağlı BasePath parametresini kullanın -- bu, HTML dosyası PDF'ye nasıl yapılır sayfasında detaylandırılmıştır.

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop    = 15;
renderer.RenderingOptions.MarginBottom = 15;
renderer.RenderingOptions.MarginLeft   = 12;
renderer.RenderingOptions.MarginRight  = 12;

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='font-size:9pt;color:#666;text-align:right;'>Monthly Report</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='font-size:8pt;text-align:center;'>{page} of {total-pages}</div>"
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Monthly Summary</h1><p>See attached data.</p>");
byte[] pdfBytes = pdf.BinaryData;

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop    = 15;
renderer.RenderingOptions.MarginBottom = 15;
renderer.RenderingOptions.MarginLeft   = 12;
renderer.RenderingOptions.MarginRight  = 12;

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='font-size:9pt;color:#666;text-align:right;'>Monthly Report</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='font-size:8pt;text-align:center;'>{page} of {total-pages}</div>"
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Monthly Summary</h1><p>See attached data.</p>");
byte[] pdfBytes = pdf.BinaryData;

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.MarginTop = 15
renderer.RenderingOptions.MarginBottom = 15
renderer.RenderingOptions.MarginLeft = 12
renderer.RenderingOptions.MarginRight = 12

renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='font-size:9pt;color:#666;text-align:right;'>Monthly Report</div>",
    .DrawDividerLine = True
}

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='font-size:8pt;text-align:center;'>{page} of {total-pages}</div>"
}

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Monthly Summary</h1><p>See attached data.</p>")
Dim pdfBytes As Byte() = pdf.BinaryData

MailKit ile PDF'yi E-postaya Nasıl Eklersiniz?

MailKit içerik tipi, kodloma ve ek metadata'u uzerinde tam kontrol vererek bir MIME mesaj ağacını doğrudan oluşturur. BodyBuilder yardımcı sınıfı, bir veya daha fazla dosya eki olan metin veya HTML metninin yaygın durumunu basitleştirir.

using IronPdf;
using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;

// Step 1 -- generate the PDF in memory
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Monthly Report</h1><p>Generated automatically.</p>");

// Step 2 -- build the email message
var message = new MimeMessage();
message.From.Add(new MailboxAddress("Reports Service", "reports@example.com"));
message.To.Add(new MailboxAddress("Alice Smith", "alice@example.com"));
message.Subject = "Your Monthly Report is Ready";

var builder = new BodyBuilder();
builder.TextBody = "Hello Alice,\n\nPlease find your monthly report attached.\n\nRegards,\nReports Service";
builder.HtmlBody = "<p>Hello Alice,</p><p>Please find your monthly report attached.</p>";

// Add the in-memory PDF as an attachment
builder.Attachments.Add("MonthlyReport.pdf", pdf.BinaryData, new ContentType("application", "pdf"));
message.Body = builder.ToMessageBody();

// Step 3 -- send via SMTP with TLS
using var client = new SmtpClient();
await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
await client.AuthenticateAsync("username", "app-password");
await client.SendAsync(message);
await client.DisconnectAsync(true);

using IronPdf;
using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;

// Step 1 -- generate the PDF in memory
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Monthly Report</h1><p>Generated automatically.</p>");

// Step 2 -- build the email message
var message = new MimeMessage();
message.From.Add(new MailboxAddress("Reports Service", "reports@example.com"));
message.To.Add(new MailboxAddress("Alice Smith", "alice@example.com"));
message.Subject = "Your Monthly Report is Ready";

var builder = new BodyBuilder();
builder.TextBody = "Hello Alice,\n\nPlease find your monthly report attached.\n\nRegards,\nReports Service";
builder.HtmlBody = "<p>Hello Alice,</p><p>Please find your monthly report attached.</p>";

// Add the in-memory PDF as an attachment
builder.Attachments.Add("MonthlyReport.pdf", pdf.BinaryData, new ContentType("application", "pdf"));
message.Body = builder.ToMessageBody();

// Step 3 -- send via SMTP with TLS
using var client = new SmtpClient();
await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
await client.AuthenticateAsync("username", "app-password");
await client.SendAsync(message);
await client.DisconnectAsync(true);

Imports IronPdf
Imports MailKit.Net.Smtp
Imports MailKit.Security
Imports MimeKit

' Step 1 -- generate the PDF in memory
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Monthly Report</h1><p>Generated automatically.</p>")

' Step 2 -- build the email message
Dim message As New MimeMessage()
message.From.Add(New MailboxAddress("Reports Service", "reports@example.com"))
message.To.Add(New MailboxAddress("Alice Smith", "alice@example.com"))
message.Subject = "Your Monthly Report is Ready"

Dim builder As New BodyBuilder()
builder.TextBody = "Hello Alice," & vbCrLf & vbCrLf & "Please find your monthly report attached." & vbCrLf & vbCrLf & "Regards," & vbCrLf & "Reports Service"
builder.HtmlBody = "<p>Hello Alice,</p><p>Please find your monthly report attached.</p>"

' Add the in-memory PDF as an attachment
builder.Attachments.Add("MonthlyReport.pdf", pdf.BinaryData, New ContentType("application", "pdf"))
message.Body = builder.ToMessageBody()

' Step 3 -- send via SMTP with TLS
Using client As New SmtpClient()
    Await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls)
    Await client.AuthenticateAsync("username", "app-password")
    Await client.SendAsync(message)
    Await client.DisconnectAsync(True)
End Using

builder.Attachments.Add üç argüman kabul eder: alıcının e-posta istemcisinde gördüğü dosya adı, pdf.BinaryData'dan gelen ham bayt dizisi ve MIME türünü application/pdf olarak belirten ContentType örneği. Async SMTP metodları, ağ işletimi tamamlanırken çağıran iş parçacığını serbest bırakır -- bu, onlarca eş zamanlı isteği işleyen ASP.NET Core kontrolörleri açısından kritiktir.

SecureSocketOptions.StartTls, 587 portundaki SMTP sunucusu ile şifreli bir kanal müzakere eder. Gmail için, hesap şifreniz yerine bir Uygulama Şifresi kullanın: Google Hesabı Güvenliği > Uygulama Şifreleri altında bir tane oluşturun ve ardından AuthenticateAsync'ya iletin. Microsoft 365 için, tenant'ınızın temel kimlik doğrulamayı devre dışı bıraktıysa, MailKit'in SaslMechanismOAuth2 sınıfı aracılığıyla OAuth 2.0 kimlik doğrulamasını yapılandırın.

message.To.Add(new MailboxAddress("Alice Smith",   "alice@example.com"));
message.To.Add(new MailboxAddress("Bob Jones",     "bob@example.com"));
message.Cc.Add(new MailboxAddress("Carol Manager", "carol@example.com"));

message.To.Add(new MailboxAddress("Alice Smith",   "alice@example.com"));
message.To.Add(new MailboxAddress("Bob Jones",     "bob@example.com"));
message.Cc.Add(new MailboxAddress("Carol Manager", "carol@example.com"));

message.To.Add(New MailboxAddress("Alice Smith", "alice@example.com"))
message.To.Add(New MailboxAddress("Bob Jones", "bob@example.com"))
message.Cc.Add(New MailboxAddress("Carol Manager", "carol@example.com"))

System.Net.Mail'i Alternatif Olarak Nasıl Kullanırsınız?

Eski .NET sürümlerini hedefleyen projeler veya üçüncü taraf bir NuGet paketinin eklenmesinin izin verilmediği projelerde, yerleşik System.Net.Mail namespace temel SMTP teslimini işler. Microsoft artık yeni geliştirmeler için bunu önermemektedir ancak ek bir bağımlılığa genel kullanılan durumlari kapsar.

using IronPdf;
using System.Net;
using System.Net.Mail;

// Generate the PDF
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Invoice #1001</h1><p>Amount due: $350.00</p>");

// Build the mail message
using var message = new MailMessage("invoices@example.com", "customer@example.com");
message.Subject = "Invoice #1001 Attached";
message.Body    = "Your invoice is attached to this email. Please remit payment within 30 days.";
message.IsBodyHtml = false;

// Wrap the byte array in a MemoryStream for the Attachment constructor
var stream = new MemoryStream(pdf.BinaryData);
message.Attachments.Add(new Attachment(stream, "Invoice-1001.pdf", "application/pdf"));

// Send via SMTP
using var client = new SmtpClient("smtp.example.com", 587)
{
    Credentials = new NetworkCredential("username", "password"),
    EnableSsl   = true
};
await client.SendMailAsync(message);

using IronPdf;
using System.Net;
using System.Net.Mail;

// Generate the PDF
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Invoice #1001</h1><p>Amount due: $350.00</p>");

// Build the mail message
using var message = new MailMessage("invoices@example.com", "customer@example.com");
message.Subject = "Invoice #1001 Attached";
message.Body    = "Your invoice is attached to this email. Please remit payment within 30 days.";
message.IsBodyHtml = false;

// Wrap the byte array in a MemoryStream for the Attachment constructor
var stream = new MemoryStream(pdf.BinaryData);
message.Attachments.Add(new Attachment(stream, "Invoice-1001.pdf", "application/pdf"));

// Send via SMTP
using var client = new SmtpClient("smtp.example.com", 587)
{
    Credentials = new NetworkCredential("username", "password"),
    EnableSsl   = true
};
await client.SendMailAsync(message);

Imports IronPdf
Imports System.Net
Imports System.Net.Mail
Imports System.IO

' Generate the PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Invoice #1001</h1><p>Amount due: $350.00</p>")

' Build the mail message
Using message As New MailMessage("invoices@example.com", "customer@example.com")
    message.Subject = "Invoice #1001 Attached"
    message.Body = "Your invoice is attached to this email. Please remit payment within 30 days."
    message.IsBodyHtml = False

    ' Wrap the byte array in a MemoryStream for the Attachment constructor
    Dim stream As New MemoryStream(pdf.BinaryData)
    message.Attachments.Add(New Attachment(stream, "Invoice-1001.pdf", "application/pdf"))

    ' Send via SMTP
    Using client As New SmtpClient("smtp.example.com", 587)
        client.Credentials = New NetworkCredential("username", "password")
        client.EnableSsl = True
        Await client.SendMailAsync(message)
    End Using
End Using

MailKit'e kıyasla ana fark System.Net.Mail.Attachment doğrudan bir bayt dizisini kabul etmez -- önce pdf.BinaryData'yı bir MemoryStream içinde sarmanız gerekir. Hem MailMessage hem de SmtpClient, gönderimden sonra SMTP bağlantısını kapatan ve alttaki akışı temizleyen using ifadelerinin içine sarılır. Eğer using'yi MailMessage üzerinde atlarsanız, bazı çalışma zamanlarında gönderim tamamlanmadan önce ek akışı devre dışı bırakılabilir.

Bu Deseni Gerçek İş Akışlarına Nasıl Uygularsınız?

Bellekteki PDF'den e-postaya deseni, çogu iş uygulamasını yönlendiren doküman otomasyon senaryolarına doğrudan uygulanabilir.

app.MapPost("/checkout", async (CheckoutRequest req, IEmailService emailService) =>
{
    var renderer = new ChromePdfRenderer();
    PdfDocument receipt = renderer.RenderHtmlAsPdf(BuildReceiptHtml(req));

    // Fire and forget -- do not await so the HTTP response is immediate
    _ = emailService.SendReceiptAsync(req.CustomerEmail, receipt.BinaryData);

    return Results.Ok(new { message = "Order confirmed." });
});

app.MapPost("/checkout", async (CheckoutRequest req, IEmailService emailService) =>
{
    var renderer = new ChromePdfRenderer();
    PdfDocument receipt = renderer.RenderHtmlAsPdf(BuildReceiptHtml(req));

    // Fire and forget -- do not await so the HTTP response is immediate
    _ = emailService.SendReceiptAsync(req.CustomerEmail, receipt.BinaryData);

    return Results.Ok(new { message = "Order confirmed." });
});

Imports System.Threading.Tasks

app.MapPost("/checkout", Async Function(req As CheckoutRequest, emailService As IEmailService) As Task(Of IResult)
    Dim renderer As New ChromePdfRenderer()
    Dim receipt As PdfDocument = renderer.RenderHtmlAsPdf(BuildReceiptHtml(req))

    ' Fire and forget -- do not await so the HTTP response is immediate
    _ = emailService.SendReceiptAsync(req.CustomerEmail, receipt.BinaryData)

    Return Results.Ok(New With {.message = "Order confirmed."})
End Function)

Hataları ve Tekrar Denemeleri Nasıl Yönetirsiniz?

Ağ işlemleri başarısız olur. SMTP sunucuları geçici olarak erişilebilir değildir, yetkilendirme jetonları süresi dolar ve ek boyut sınırları sağlayıcıya göre değişir. E-posta gönderim yolunda baştan itibaren dayanıklılığı kurun.

MailKit gönderim mantığını bir try/catch içine sarın ve yeniden denenmeleri için başarsızlıkları kalıcı bir kuyruğa kaydedin:

using IronPdf;
using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;
using Microsoft.Extensions.Logging;

async Task SendPdfEmailWithRetryAsync(
    byte[] pdfBytes,
    string recipientEmail,
    string subject,
    ILogger logger,
    int maxAttempts = 3)
{
    for (int attempt = 1; attempt <= maxAttempts; attempt++)
    {
        try
        {
            var message = new MimeMessage();
            message.From.Add(new MailboxAddress("Mailer", "mailer@example.com"));
            message.To.Add(MailboxAddress.Parse(recipientEmail));
            message.Subject = subject;

            var builder = new BodyBuilder { TextBody = "Your document is attached." };
            builder.Attachments.Add("document.pdf", pdfBytes, new ContentType("application", "pdf"));
            message.Body = builder.ToMessageBody();

            using var smtpClient = new SmtpClient();
            await smtpClient.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
            await smtpClient.AuthenticateAsync("user", "pass");
            await smtpClient.SendAsync(message);
            await smtpClient.DisconnectAsync(true);

            logger.LogInformation("Email sent to {Email} on attempt {Attempt}", recipientEmail, attempt);
            return;
        }
        catch (Exception ex) when (attempt < maxAttempts)
        {
            logger.LogWarning(ex, "Send attempt {Attempt} failed. Retrying...", attempt);
            await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)));
        }
    }
}

using IronPdf;
using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;
using Microsoft.Extensions.Logging;

async Task SendPdfEmailWithRetryAsync(
    byte[] pdfBytes,
    string recipientEmail,
    string subject,
    ILogger logger,
    int maxAttempts = 3)
{
    for (int attempt = 1; attempt <= maxAttempts; attempt++)
    {
        try
        {
            var message = new MimeMessage();
            message.From.Add(new MailboxAddress("Mailer", "mailer@example.com"));
            message.To.Add(MailboxAddress.Parse(recipientEmail));
            message.Subject = subject;

            var builder = new BodyBuilder { TextBody = "Your document is attached." };
            builder.Attachments.Add("document.pdf", pdfBytes, new ContentType("application", "pdf"));
            message.Body = builder.ToMessageBody();

            using var smtpClient = new SmtpClient();
            await smtpClient.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
            await smtpClient.AuthenticateAsync("user", "pass");
            await smtpClient.SendAsync(message);
            await smtpClient.DisconnectAsync(true);

            logger.LogInformation("Email sent to {Email} on attempt {Attempt}", recipientEmail, attempt);
            return;
        }
        catch (Exception ex) when (attempt < maxAttempts)
        {
            logger.LogWarning(ex, "Send attempt {Attempt} failed. Retrying...", attempt);
            await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)));
        }
    }
}

Imports IronPdf
Imports MailKit.Net.Smtp
Imports MailKit.Security
Imports MimeKit
Imports Microsoft.Extensions.Logging

Public Async Function SendPdfEmailWithRetryAsync(
    pdfBytes As Byte(),
    recipientEmail As String,
    subject As String,
    logger As ILogger,
    Optional maxAttempts As Integer = 3) As Task

    For attempt As Integer = 1 To maxAttempts
        Try
            Dim message = New MimeMessage()
            message.From.Add(New MailboxAddress("Mailer", "mailer@example.com"))
            message.To.Add(MailboxAddress.Parse(recipientEmail))
            message.Subject = subject

            Dim builder = New BodyBuilder With {
                .TextBody = "Your document is attached."
            }
            builder.Attachments.Add("document.pdf", pdfBytes, New ContentType("application", "pdf"))
            message.Body = builder.ToMessageBody()

            Using smtpClient = New SmtpClient()
                Await smtpClient.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls)
                Await smtpClient.AuthenticateAsync("user", "pass")
                Await smtpClient.SendAsync(message)
                Await smtpClient.DisconnectAsync(True)
            End Using

            logger.LogInformation("Email sent to {Email} on attempt {Attempt}", recipientEmail, attempt)
            Return
        Catch ex As Exception When attempt < maxAttempts
            logger.LogWarning(ex, "Send attempt {Attempt} failed. Retrying...", attempt)
            Await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)))
        End Try
    Next
End Function

Üstel geri alma -- ilk başarısızlıktan sonra 2 saniye, ikincisinden sonra 4 -- aşırı yüklenmiş bir SMTP sunucusunu dövmeyi önler. Üretim uygulamalarında, yeniden deneme döngüsünü (Azure Service Bus, RabbitMQ veya AWS SQS) içeren bir mesaj kuyruğu ile değiştirin, böylece hata uygulama yeniden başlatmalarından kurtulur.

IronPDF, HTML içeriği render edilemezse bir PdfException da fırlatır. Bunu SMTP istisnalarindan ayrı olarak yakalayın, bu şekilde hata mesajı özeldir:

PdfDocument pdf;
try
{
    pdf = renderer.RenderHtmlAsPdf(htmlContent);
}
catch (IronPdf.Exceptions.PdfException ex)
{
    logger.LogError(ex, "PDF rendering failed");
    throw;
}

PdfDocument pdf;
try
{
    pdf = renderer.RenderHtmlAsPdf(htmlContent);
}
catch (IronPdf.Exceptions.PdfException ex)
{
    logger.LogError(ex, "PDF rendering failed");
    throw;
}

Imports IronPdf.Exceptions

Dim pdf As PdfDocument
Try
    pdf = renderer.RenderHtmlAsPdf(htmlContent)
Catch ex As PdfException
    logger.LogError(ex, "PDF rendering failed")
    Throw
End Try

Render hatalarını teslim hatalarından ayırmak, hata ayıklamaları hızlandırır. Otomatik doküman boru hatlarındaki hata yönetimine geniş bir bakış için , 5 adımda PDF oluşturma kılavuzu doğrulama desenlerini ayrıntılı bir şekilde ele alır.

Ek Boyutunu Sağlayıcı Sınırlarının Altında Nasıl Tutarsınız?

Çoğu ticari e-posta sağlayıcısı maksimum ek boyutu uygular. Gmail bireysel ekleri 25 MB ile sinirlar; Microsoft 365, standart posta kutuları için varsayılan olarak 20 MB belirlemiştir. Ağır bir şekilde stillenmiş HTML raporu, gömülü resimlerle beklenmedik bir şekilde bu sınırları aşabilir.

Bu sınırlar içinde kalmak için üç teknik:

Render işleminden önce resimleri sıkıştırın. Satır içi resimler, sıkıştırılmış JPEG veya WebP kullanmalıdır; sıkıştırılmamış PNG yerine. 600 dpi bir PNG logosu PDF'ye birkaç megabayt ekleyebilir; aynı görsel sonuç için % 85 kalitede bir JPEG genellikle 200 KB'ın altındadır.

IronPDF'in sıkıştırma ayarlarını kullanın. PdfDocument.CompressImages metodu, render işlemi sonrası yerleştirilmiş bit eşlem çözünürlüğünü azaltır. BinaryData'yi okumanızdan önce çağırın:

pdf.CompressImages(60); // quality 0-100
byte[] compressedPdfBytes = pdf.BinaryData;

pdf.CompressImages(60); // quality 0-100
byte[] compressedPdfBytes = pdf.BinaryData;

pdf.CompressImages(60) ' quality 0-100
Dim compressedPdfBytes As Byte() = pdf.BinaryData

Büyük raporları birden fazla e-posta olarak bölün. Sıkıştırma işleminden sonra bile sağlayıcı sınırını aşarsa, her bölüme bir PDF oluşturun ve her birini ayrı bir e-postayla gönderin. PDF ayırma ve birleştirme nasıl yapılır sayfası, bir PdfDocument'yi sayfa aralığına göre CopyPages kullanarak nasıl böleceğinizi gösterir.

SMTP boyut sınırları için dış referanslar: Gmail ek sınırları, Microsoft 365 mesaj boyut sınırları.

Sıradaki Adımlarınız Neler?

Artık hafızada IronPDF ile bir PDF oluşturmak ve MailKit veya System.Net.Mail kullanarak e-posta eki olarak göndermek için çalışan bir şablonunuz var. Bellekteki yaklaşım, disk okuma ve yazmalarını ortadan kaldırır, kapsayıcılı dağıtımları basitleştirir ve geçici dosya temizliği gerektirmeden yüksek verimlilikli senaryoları ölçeklendirmeyi sağlar.

Entegrasyonu daha da derinleştirmek için:

• Başlıklara, altbilgilere ve sayfa numaralamaya sahip karmaşık belge düzenlerini öğrenmek için HTML to PDF eğitimini okuyun.
• Kenar boşluklarını, sayfa boyutunu ve JavaScript çalıştırma zaman aşımını kontrol etmek için özel PDF render seçeneklerini keşfedin.
• Alıcılara düzenlenemez belgeler sağlamak için, eklemeden önce oluşturulan PDF'ye dijital imza ekleyin.
• Sunucusuz ölçekte belge üretimi için Azure İşlevlerine veya Uygulama Hizmetine dağıtın.
• Üretim lisansına karar vermeden önce tüm özellik setini test etmek için IronPDF'yi ücretsiz deneyin veya dağıtım fiyatlarını incelemek için lisanslama seçeneklerini gözden geçirin.