BCL Technologies, l'éditeur d'origine du SDK easyPDF, a été acquis par Apryse (anciennement PDFTron) en mars 2020, et le produit est maintenant positionné en tant que SDK hérité aux côtés du SDK PDF Apryse. Le SDK lui-même dépend de plusieurs technologies héritées qui créent des défis de déploiement et de maintenance dans les environnements de développement modernes.
Les développeurs rencontrent fréquemment ces problèmes lorsqu'ils travaillent avec Easy PDF SDK:
bcl.easypdf.interop.easypdfprinter.dll error loadingCOM object that has been separated from its underlying RCW cannot be usedTimeout expired waiting for print job to completeThe printer operation failed because the service is not runningError: Access denied (session interactive requise)Cannot find printer: BCL easyPDF PrinterCes erreurs proviennent généralement de l'architecture du SDK Easy PDF, qui repose sur des pilotes d'imprimante virtuelle, l'interopérabilité COM et des sessions interactives Windows difficiles à reproduire dans les environnements serveurs modernes.
| Fonction | Easy PDF SDK | IronPDF |
|---|---|---|
| Plateforme | Windows uniquement | Windows, Linux, macOS, Docker |
| Dépendance bureautique | Les exigences sont les suivantes | None |
| Distribution | Installateur MSI + références DLL manuelles (pas de package NuGet) | Paquet NuGet (IronPdf) |
| Installation | MSI + pilote d'imprimante virtuelle + enregistrement COM | Paquet NuGet |
| Support serveur | Nécessite généralement une session interactive Windows | Fonctionne sans tête |
| Rendu HTML | Basique (bureautique) | Chromium complet (CSS3, JS) |
| Support .NET | Limited .NET Core | .NET Framework 4.6.2+ et .NET 5/6/7/8/9 |
| Async Pattern | Basé sur des rappels | Async/await natif |
| Support de conteneurs | Non pris en charge par le fournisseur | Docker/Kubernetes complet |
Le SDK Easy PDF cible Windows et repose sur des installations Microsoft Office pour convertir les documents Office, ce qui limite son utilisation sur Linux, macOS et dans des environnements conteneurisés comme Docker. Cette dépendance a tendance à rendre les configurations de serveur plus complexes et lie le déploiement à Windows — une contrainte pour les équipes pratiquant le DevOps multi-plateformes ou s'appuyant sur des conteneurs Linux.
Assurez-vous que votre environnement répond à ces exigences :
Exécutez ces commandes dans votre répertoire de solutions pour identifier toutes les références à Easy PDF SDK:
# Find all BCL using statements
grep -r "using BCL" --include="*.cs" .
# Find Printer/PDFDocument usage
grep -r "Printer\|PDFDocument\|PDFConverter\|HTMLConverter" --include="*.cs" .
# Find COM interop references
grep -r "easyPDF\|BCL.easyPDF" --include="*.csproj" .
# Find configuration settings
grep -r "PageOrientation\|TimeOut\|PrintOffice" --include="*.cs" .| Modèle Easy PDF SDK | Changements requis |
|---|---|
new Printer() | Utiliser ChromePdfRenderer |
PrintOfficeDocToPDF() | La conversion bureautique traitée différemment |
RenderHTMLToPDF() | RenderHtmlAsPdf() |
| Références d'interopérabilité COM | Supprimer entièrement |
| Configuration du pilote d'imprimante | Pas nécessaire |
BeginPrintToFile() rappels | Async/await natif |
| Exigences relatives aux sessions interactives | Fonctionne sans tête |
| indexation des pages basée sur 1 | indexation basée sur 0 |
| Délai d'attente en secondes | Délai d'attente en millisecondes |
Le SDK Easy PDF est distribué sous forme d'un installateur MSI plutôt que d'un paquet NuGet, et les projets référencent généralement ses assemblages (tels que BCL.easyPDF.PDFConverter.dll pour le .NET Framework ou BCL.easyPDF.PDFConverter.NetCore.dll for .NET Core) directement. Supprimez toutes les références :
<Reference> de votre .csproj# Install IronPDF
dotnet add package IronPdfOu via la console du Package Manager :
Remplacez les espaces de noms Easy PDF SDKpar IronPDF:
// Remove these
using BCL.easyPDF;
using BCL.easyPDF.PDFConverter;
using BCL.easyPDF.PDFProcessor;
using BCL.easyPDF.Printer;
// Add these
using IronPdf;
using IronPdf.Rendering;Imports IronPdf
Imports IronPdf.Rendering| Classe Easy PDF SDK | Équivalent d'IronPDF |
|---|---|
Printer | ChromePdfRenderer |
PDFDocument | PdfDocument |
HTMLConverter | ChromePdfRenderer |
PrinterConfiguration | ChromePdfRenderOptions |
PageOrientation | PdfPaperOrientation |
PageSize | PdfPaperSize |
SecurityHandler | PdfDocument.SecuritySettings |
| Méthode Easy PDF SDK | Méthode IronPDF |
|---|---|
printer.RenderHTMLToPDF(html, path) | renderer.RenderHtmlAsPdf(html).SaveAs(path) |
printer.RenderUrlToPDF(url, path) | renderer.RenderUrlAsPdf(url).SaveAs(path) |
htmlConverter.ConvertHTML(html, doc) | renderer.RenderHtmlAsPdf(html) |
htmlConverter.ConvertURL(url, doc) | renderer.RenderUrlAsPdf(url) |
| Méthode Easy PDF SDK | Méthode IronPDF |
|---|---|
doc.Append(doc2) | PdfDocument.Merge(pdf1, pdf2) |
doc.ExtractPages(start, end) | pdf.CopyPages(start, end) |
doc.DeletePage(index) | pdf.RemovePages(index) |
doc.GetPageCount() | pdf.PageCount |
doc.Save(path) | pdf.SaveAs(path) |
doc.Close() | pdf.Dispose() ou using |
doc.ExtractText() | pdf.ExtractAllText() |
| Option SDK Easy PDF | Option IronPDF |
|---|---|
config.TimeOut | RenderingOptions.Timeout |
config.PageOrientation = Landscape | RenderingOptions.PaperOrientation = Landscape |
config.PageSize = A4 | RenderingOptions.PaperSize = PdfPaperSize.A4 |
config.MarginTop/Bottom/Left/Right | RenderingOptions.MarginTop, etc. |
Mise en œuvre facile du SDK PDF:
// Reference BCL.easyPDF.PDFConverter.dll (or the .NetCore variant)
// installed by the easyPDF SDK MSI — there is no NuGet package.
using BCL.easyPDF;
using System;
class Program
{
static void Main()
{
var pdf = new PDFDocument();
var htmlConverter = new HTMLConverter();
htmlConverter.ConvertHTML("<h1>Hello World</h1>", pdf);
pdf.Save("output.pdf");
pdf.Close();
}
}Imports BCL.easyPDF
Imports System
Class Program
Shared Sub Main()
Dim pdf As New PDFDocument()
Dim htmlConverter As New HTMLConverter()
htmlConverter.ConvertHTML("<h1>Hello World</h1>", pdf)
pdf.Save("output.pdf")
pdf.Close()
End Sub
End ClassMise en œuvre d'IronPDF:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
pdf.SaveAs("output.pdf");
}
}Imports IronPdf
Imports System
Class Program
Shared Sub Main()
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
pdf.SaveAs("output.pdf")
End Sub
End ClassIronPDF intègre le rendu HTML dans un seul appel de rendu et permet à Dispose de gérer le nettoyage, éliminant l'étape HTMLConverter séparée et le modèle Close() manuel.
Mise en œuvre facile du SDK PDF:
// Reference BCL.easyPDF.PDFConverter.dll (or the .NetCore variant)
// installed by the easyPDF SDK MSI — there is no NuGet package.
using BCL.easyPDF;
using System;
class Program
{
static void Main()
{
var pdf = new PDFDocument();
var htmlConverter = new HTMLConverter();
htmlConverter.ConvertURL("https://example.com", pdf);
pdf.Save("webpage.pdf");
pdf.Close();
}
}Imports BCL.easyPDF
Imports System
Class Program
Shared Sub Main()
Dim pdf As New PDFDocument()
Dim htmlConverter As New HTMLConverter()
htmlConverter.ConvertURL("https://example.com", pdf)
pdf.Save("webpage.pdf")
pdf.Close()
End Sub
End ClassMise en œuvre d'IronPDF:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
}
}Imports IronPdf
Imports System
Module Program
Sub Main()
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("webpage.pdf")
End Sub
End ModuleMise en œuvre facile du SDK PDF:
// Reference BCL.easyPDF.PDFConverter.dll (or the .NetCore variant)
// installed by the easyPDF SDK MSI — there is no NuGet package.
using BCL.easyPDF;
using System;
class Program
{
static void Main()
{
var pdf1 = new PDFDocument("document1.pdf");
var pdf2 = new PDFDocument("document2.pdf");
pdf1.Append(pdf2);
pdf1.Save("merged.pdf");
pdf1.Close();
pdf2.Close();
}
}Imports BCL.easyPDF
Imports System
Module Program
Sub Main()
Dim pdf1 As New PDFDocument("document1.pdf")
Dim pdf2 As New PDFDocument("document2.pdf")
pdf1.Append(pdf2)
pdf1.Save("merged.pdf")
pdf1.Close()
pdf2.Close()
End Sub
End ModuleMise en œuvre d'IronPDF:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
var pdfs = new List<PdfDocument>
{
PdfDocument.FromFile("document1.pdf"),
PdfDocument.FromFile("document2.pdf")
};
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs("merged.pdf");
}
}Imports IronPdf
Imports System
Imports System.Collections.Generic
Module Program
Sub Main()
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim pdfs As New List(Of PdfDocument) From {
PdfDocument.FromFile("document1.pdf"),
PdfDocument.FromFile("document2.pdf")
}
Dim merged = PdfDocument.Merge(pdfs)
merged.SaveAs("merged.pdf")
End Sub
End ModuleLa méthode statique Merge d'IronPDF accepte directement une collection de documents, remplaçant le modèle Append par paire.
Mise en œuvre d'IronPDF:
using IronPdf;
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>");
// Set security
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;
pdf.SaveAs("protected.pdf");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>")
' Set security
pdf.SecuritySettings.UserPassword = "user123"
pdf.SecuritySettings.OwnerPassword = "owner456"
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit
pdf.SaveAs("protected.pdf")Le SDK Easy PDF n'expose pas d'API de header/footer dédiées dans son chemin de conversion HTML ; les en-têtes et pieds de page sont généralement intégrés directement dans le HTML source.IronPDF fournit des objets de header/footer dédiés :
using IronPdf;
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
HtmlFragment = @"
<div style='text-align:center; font-size:12px; font-family:Arial;'>
Company Name - Confidential
</div>",
DrawDividerLine = true,
MaxHeight = 30
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
HtmlFragment = @"
<div style='text-align:center; font-size:10px;'>
Page {page} of {total-pages}
</div>",
DrawDividerLine = true,
MaxHeight = 25
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Content</h1>");
pdf.SaveAs("with_headers.pdf");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
.HtmlFragment = "
<div style='text-align:center; font-size:12px; font-family:Arial;'>
Company Name - Confidential
</div>",
.DrawDividerLine = True,
.MaxHeight = 30
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
.HtmlFragment = "
<div style='text-align:center; font-size:10px;'>
Page {page} of {total-pages}
</div>",
.DrawDividerLine = True,
.MaxHeight = 25
}
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Content</h1>")
pdf.SaveAs("with_headers.pdf")Pour plus d'options, consultez la documentation sur les en-têtes et les pieds de page.
Easy PDF SDK utilise des modèles asynchrones basés sur des rappels.IronPDF prend en charge les fonctions natives async/await :
Mise en œuvre facile du SDK PDF:
using BCL.easyPDF;
Printer printer = new Printer();
// BCL uses callback-based async
printer.BeginPrintToFile(
"https://example.com",
"output.pdf",
OnPrintComplete,
OnPrintError
);
Console.ReadLine();
printer.Dispose();Imports BCL.easyPDF
Dim printer As New Printer()
' BCL uses callback-based async
printer.BeginPrintToFile( _
"https://example.com", _
"output.pdf", _
AddressOf OnPrintComplete, _
AddressOf OnPrintError _
)
Console.ReadLine()
printer.Dispose()Mise en œuvre d'IronPDF:
using IronPdf;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var renderer = new ChromePdfRenderer();
// Native async/await
var pdf = await renderer.RenderUrlAsPdfAsync("https://example.com");
await pdf.SaveAsAsync("output.pdf");
Console.WriteLine("PDF created: output.pdf");
}
}Imports IronPdf
Imports System.Threading.Tasks
Class Program
Shared Async Function Main() As Task
Dim renderer = New ChromePdfRenderer()
' Native async/await
Dim pdf = Await renderer.RenderUrlAsPdfAsync("https://example.com")
Await pdf.SaveAsAsync("output.pdf")
Console.WriteLine("PDF created: output.pdf")
End Function
End ClassEasy PDF SDK utilise une indexation basée sur 1.IronPDF utilise une indexation basée sur 0 :
// Easy PDF SDK: 1-based
doc.ExtractPages(1, 5);
// IronPDF: 0-based
pdf.CopyPages(0, 4);' Easy PDF SDK: 1-based
doc.ExtractPages(1, 5)
' IronPDF: 0-based
pdf.CopyPages(0, 4)Easy PDF SDK utilise des secondes pour les valeurs de délai d'attente.IronPDF utilise des millisecondes :
// Easy PDF SDK: seconds
config.TimeOut = 120;
// IronPDF: milliseconds
renderer.RenderingOptions.Timeout = 120000;' Easy PDF SDK: seconds
config.TimeOut = 120
' IronPDF: milliseconds
renderer.RenderingOptions.Timeout = 120000Easy PDF SDK a du mal à s'adapter aux contextes web en raison des exigences liées aux sessions interactives.
Modèle IronPDF:
[ApiController]
[Route("[controller]")]
public class PdfController : ControllerBase
{
[HttpGet("generate")]
public IActionResult GeneratePdf()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");
return File(pdf.BinaryData, "application/pdf", "report.pdf");
}
[HttpGet("generate-async")]
public async Task<IActionResult> GeneratePdfAsync()
{
var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Report</h1>");
return File(pdf.BinaryData, "application/pdf", "report.pdf");
}
}Imports Microsoft.AspNetCore.Mvc
<ApiController>
<Route("[controller]")>
Public Class PdfController
Inherits ControllerBase
<HttpGet("generate")>
Public Function GeneratePdf() As IActionResult
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>")
Return File(pdf.BinaryData, "application/pdf", "report.pdf")
End Function
<HttpGet("generate-async")>
Public Async Function GeneratePdfAsync() As Task(Of IActionResult)
Dim renderer = New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Report</h1>")
Return File(pdf.BinaryData, "application/pdf", "report.pdf")
End Function
End ClassLe SDK Easy PDF n'est pas conçu pour les conteneurs Linux — sa configuration prise en charge est Windows avec Microsoft Office, un pilote d'imprimante virtuelle, et (dans la plupart des configurations) une session interactive de bureau, ce qui rend les flux de travail typiques basés sur Docker sous Linux difficiles à réaliser.
Configuration IronPDF Docker :
FROM mcr.microsoft.com/dotnet/aspnet:8.0
# Install Chromium dependencies
RUN apt-get update && apt-get install -y \
libc6 libgdiplus libx11-6 libxcomposite1 \
libxdamage1 libxrandr2 libxss1 libxtst6 \
libnss3 libatk-bridge2.0-0 libgtk-3-0 \
libgbm1 libasound2 fonts-liberation \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY . .
ENTRYPOINT ["dotnet", "MyApp.dll"]Symptôme : Cannot find printer: BCL easyPDF Printer
**Solution:**IronPDF n'a pas besoin de pilotes d'imprimante :
// Just use the renderer directly
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)Symptom: DLL error loading or RCW errors
Solution: Supprimer toutes les références COM et utiliser l'API gérée d'IronPDF.
Symptôme: La génération de PDF se bloque sur le serveur web
**Solution:**IronPDF fonctionne sans tête, sans sessions interactives :
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.Timeout = 60000; // Reliable timeout
var pdf = renderer.RenderHtmlAsPdf(html);Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.Timeout = 60000 ' Reliable timeout
Dim pdf = renderer.RenderHtmlAsPdf(html)Symptôme: Les arrière-plans CSS sont manquants
Solution: Activer l'impression en arrière-plan :
renderer.RenderingOptions.PrintHtmlBackgrounds = true;renderer.RenderingOptions.PrintHtmlBackgrounds = TrueAprès avoir effectué la migration du code, vérifiez les points suivants :
La migration du SDK Easy PDF à IronPDF supprime le pilote d'imprimante virtuelle, l'interopérabilité COM, et les contraintes Windows uniquement du chemin de génération PDF. Le rendu basé sur Chromium offre un support moderne de CSS3 et JavaScript, et le même code source s'exécute sur Docker, Kubernetes et les environnements cloud basés sur Linux qui sont difficiles à cibler avec le modèle de déploiement pris en charge par le SDK easyPDF.
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
