BitMiracle Docotic PDF est une bibliothèque PDF .NET réputée pour son architecture de code géré à 100 % et ses capacités étendues de manipulation programmatique des PDF. Toutefois, la structure modulaire de ces outils, qui nécessite des modules distincts pour la conversion HTML-PDF, la mise en page et d'autres fonctionnalités, complique la gestion du projet et l'octroi des licences. Ce guide complet fournit un chemin de migration étape par étape de BitMiracle Docotic PDFvers IronPDF- une bibliothèque PDF .NET unifiée avec un rendu HTML intégré basé sur Chromium et toutes les fonctionnalités incluses dans un seul package NuGet.
Bien que BitMiracle Docotic PDFoffre de solides fonctionnalités de manipulation de PDF, plusieurs facteurs poussent les équipes de développement à rechercher des alternatives avec une architecture plus rationalisée.
BitMiracle Docotic PDF utilise une approche modulaire qui nécessite plusieurs packages pour une fonctionnalité complète :
| Aspect | BitMiracle Docotic PDF | IronPDF |
|---|---|---|
| HTML-à-PDF | Nécessite un module complémentaire séparé (HtmlToPdf) | Fonctionnalité principale intégrée |
| Structure du paquet | Core + plusieurs add-ons | Paquet NuGet unique |
| Modèle de licence | Licence d'utilisation à l'unité | Toutes les fonctionnalités sont incluses |
| Complexité de l'API | Espaces de noms séparés par module complémentaire | API unifiée |
| HTML Engine | Chromium (via un module complémentaire) | Chromium (intégré) |
| Taille de la communauté | Plus petit | Plus grand, plus de ressources |
| Documentation | Référence technique | Tutoriels détaillés |
Les deux bibliothèques prennent en charge des fonctionnalités PDF complètes :
| Fonction | BitMiracle Docotic PDF | IronPDF |
|---|---|---|
| Créer un PDF à partir de zéro | ✅ | ✅ |
| HTML vers PDF | ✅(module complémentaire requis) | ✅(intégré) |
| URL vers PDF | ✅(module complémentaire requis) | ✅(intégré) |
| Manipulation PDF | ✅ | ✅ |
| Extraction de texte | ✅ | ✅ |
| Fusionner/Séparer | ✅ | ✅ |
| Signatures numériques | ✅ | ✅ |
| Chiffrement | ✅ | ✅ |
| Remplissage de formulaires | ✅ | ✅ |
| Conformité PDF/A | ✅ | ✅ |
BitMiracle Docotic PDF utilise un dessin basé sur le canevas avec un positionnement par coordonnées (canvas.DrawString(x, y, text)), tandis qu'IronPDF s'appuie sur HTML/CSS pour la mise en page et le positionnement. Il s'agit d'un changement de paradigme qui simplifie la création de contenu pour les développeurs familiarisés avec les technologies web.
Assurez-vous que votre environnement répond à ces exigences :
Exécutez ces commandes dans le répertoire de votre solution pour identifier toutes les références à Docotic.Pdf :
# Find all Docotic.Pdf usages in your codebase
grep -r "using BitMiracle.Docotic" --include="*.cs" .
grep -r "PdfDocument\|PdfPage\|PdfCanvas" --include="*.cs" .
# Find NuGet package references
grep -r "Docotic.Pdf" --include="*.csproj" .| Changement | BitMiracle Docotic PDF | IronPDF | Impact |
|---|---|---|---|
| Rendu HTML | Nécessite le module complémentaire HtmlToPdf | Intégré | Supprimer le paquet de modules complémentaires |
| Indexation des pages | 0-based (Pages[0]) | 0-based (Pages[0]) | Aucune modification n'est nécessaire |
| Système de coordination | Origine en bas à gauche | Flux HTML/CSS | Utiliser CSS pour le positionnement |
| Dessin sur toile | PdfCanvas.DrawText() | Balisage HTML | Changement de paradigme |
| Extraction de texte | page.GetText() | pdf.ExtractAllText() | Changement de nom de la méthode |
| Chargement de documents | new PdfDocument(path) | PdfDocument.FromFile(path) | Constructeur → méthode statique |
| Économie | document.Save(path) | pdf.SaveAs(path) | Changement de nom de la méthode |
| Disposition | IDisposable modèle | Non requis | Gestion simplifiée des ressources |
Supprimez les paquets BitMiracle Docotic PDFet installez IronPDF:
# Remove Docotic.Pdf packages
dotnet remove package BitMiracle.Docotic.Pdf
dotnet remove package BitMiracle.Docotic.Pdf.HtmlToPdf
dotnet remove package BitMiracle.Docotic.Pdf.Layout
# Install IronPDF
dotnet add package IronPdfRemplacer les espaces de noms PDF de BitMiracle Docotic par IronPDF:
// Remove these
using BitMiracle.Docotic.Pdf;
using BitMiracle.Docotic.Pdf.Layout;
// HtmlConverter from the BitMiracle.Docotic.Pdf.HtmlToPdf NuGet package
// also lives in the BitMiracle.Docotic.Pdf namespace (no extra using needed).
// Add this
using IronPdf;Imports IronPdf// Add at application startup (Program.cs or Global.asax)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";' Add at application startup (Program.vb or Global.asax)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"| Tâches | BitMiracle Docotic PDF | IronPDF |
|---|---|---|
| Créer un document vide | new PdfDocument() | new PdfDocument() |
| Charger à partir d'un fichier | new PdfDocument(path) | PdfDocument.FromFile(path) |
| Charger à partir du flux | PdfDocument.Load(stream) | PdfDocument.FromStream(stream) |
| Chargement à partir d'octets | PdfDocument.Load(bytes) | PdfDocument.FromBinaryData(bytes) |
| Enregistrer dans un fichier | document.Save(path) | pdf.SaveAs(path) |
| Obtenir le nombre de pages | document.PageCount | pdf.PageCount |
| Fermer/Disposer | document.Dispose() | Non requis |
| Tâches | BitMiracle Docotic PDF(module complémentaire HtmlToPdf) | IronPDF |
|---|---|---|
| Chaîne HTML vers PDF | await converter.CreatePdfFromStringAsync(html) | renderer.RenderHtmlAsPdf(html) |
| Fichier HTML vers PDF | await converter.CreatePdfAsync(filePath) | renderer.RenderHtmlFileAsPdf(path) |
| URL vers PDF | await converter.CreatePdfAsync(new Uri(url)) | renderer.RenderUrlAsPdf(url) |
| Définir la taille de la page | options.Page.SetSize(PdfPaperSize.A4) | renderer.RenderingOptions.PaperSize = PdfPaperSize.A4 |
| Définir les marges | options.Page.MarginTop = 20 (etc.) | renderer.RenderingOptions.MarginTop = 20 |
| Tâches | BitMiracle Docotic PDF | IronPDF |
|---|---|---|
| Fusionner des documents | doc1.Append("file.pdf") (path/Stream/bytes) | PdfDocument.Merge(pdf1, pdf2) |
| Document fractionné | document.CopyPage(index) vers un nouveau document | pdf.CopyPages(start, end) |
L'opération la plus courante démontre la simplification significative qu'IronPDF apporte.
Mise en œuvre de BitMiracle Docotic PDF:
// NuGet: Install-Package BitMiracle.Docotic.Pdf
// NuGet: Install-Package BitMiracle.Docotic.Pdf.HtmlToPdf (separate add-on required)
using BitMiracle.Docotic.Pdf;
using System;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
// HtmlConverter is async-only and downloads Chromium on first use
using var converter = await HtmlConverter.CreateAsync();
string html = "<html><body><h1>Hello World</h1><p>This is HTML vers PDFconversion.</p></body></html>";
using var pdf = await converter.CreatePdfFromStringAsync(html);
pdf.Save("output.pdf");
Console.WriteLine("PDF created successfully");
}
}Mise en œuvre d'IronPDF:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
string html = "<html><body><h1>Hello World</h1><p>This is HTML vers PDFconversion.</p></body></html>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF created successfully");
}
}IronPDF élimine le besoin de l'instruction using et fournit une classe ChromePdfRenderer dédiée qui indique clairement sa capacité de rendu basée sur Chromium. Pour plus d'options de conversion HTML, consultez la documentation HTML au format PDF.
Mise en œuvre de BitMiracle Docotic PDF:
// NuGet: Install-Package BitMiracle.Docotic.Pdf
using BitMiracle.Docotic.Pdf;
using System;
class Program
{
static void Main()
{
using (var pdf1 = new PdfDocument("document1.pdf"))
{
// PdfDocument.Append accepts a file path, Stream, or byte[] —
// not another PdfDocument instance.
pdf1.Append("document2.pdf");
pdf1.Save("merged.pdf");
}
Console.WriteLine("PDFs merged successfully");
}
}Imports BitMiracle.Docotic.Pdf
Imports System
Class Program
Shared Sub Main()
Using pdf1 As New PdfDocument("document1.pdf")
' PdfDocument.Append accepts a file path, Stream, or byte[] —
' not another PdfDocument instance.
pdf1.Append("document2.pdf")
pdf1.Save("merged.pdf")
End Using
Console.WriteLine("PDFs merged successfully")
End Sub
End ClassMise en œuvre d'IronPDF:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(new List<PdfDocument> { pdf1, pdf2 });
merged.SaveAs("merged.pdf");
Console.WriteLine("PDFs merged successfully");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Imports System.Collections.Generic
Module Program
Sub Main()
Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(New List(Of PdfDocument) From {pdf1, pdf2})
merged.SaveAs("merged.pdf")
Console.WriteLine("PDFs merged successfully")
End Sub
End ModuleLa méthode statique Merge d'IronPDF accepte directement plusieurs documents, offrant une API plus propre que le modèle itératif Append. Pour plus d'options, consultez la documentation sur la fusion de fichiers PDF .
Mise en œuvre de BitMiracle Docotic PDF:
// NuGet: Install-Package BitMiracle.Docotic.Pdf
using BitMiracle.Docotic.Pdf;
using System;
class Program
{
static void Main()
{
using (var pdf = new PdfDocument("document.pdf"))
{
string allText = "";
foreach (var page in pdf.Pages)
{
allText += page.GetText();
}
Console.WriteLine("Extracted text:");
Console.WriteLine(allText);
}
}
}Mise en œuvre d'IronPDF:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
var pdf = PdfDocument.FromFile("document.pdf");
string allText = pdf.ExtractAllText();
Console.WriteLine("Extracted text:");
Console.WriteLine(allText);
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module Program
Sub Main()
Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")
Dim allText As String = pdf.ExtractAllText()
Console.WriteLine("Extracted text:")
Console.WriteLine(allText)
End Sub
End ModuleIronPDF réduit l'extraction de texte d'une boucle de plusieurs lignes à un seul appel de méthode. Pour plus d'options d'extraction, consultez la documentation sur l'extraction de texte .
Mise en œuvre d'IronPDF:
using IronPdf;
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Document</h1>");
// Set security
pdf.SecuritySettings.UserPassword = "userPassword";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SaveAs("protected.pdf");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Document</h1>")
' Set security
pdf.SecuritySettings.UserPassword = "userPassword"
pdf.SecuritySettings.OwnerPassword = "ownerPassword"
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SaveAs("protected.pdf")Pour connaître toutes les options de sécurité, consultez la documentation sur le chiffrement .
Mise en œuvre d'IronPDF:
using IronPdf;
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
HtmlFragment = @"
<div style='text-align:center; font-size:12px;'>
Company Header - 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>Document 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;'>
Company Header - 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>Document Content</h1>")
pdf.SaveAs("with_headers.pdf")IronPDF prend en charge des jetons de remplacement comme {page} et {total-pages} pour la numérotation dynamique des pages. Pour plus d'options, consultez la documentation sur les en-têtes et les pieds de page.
L'approche de dessin basée sur le canevas de BitMiracle Docotic PDFdoit être convertie en HTML avec un positionnement CSS :
Modèle PDF docotic BitMiracle :
var canvas = pdfPage.Canvas;
canvas.DrawString(50, 50, "Hello, World!");Dim canvas = pdfPage.Canvas
canvas.DrawString(50, 50, "Hello, World!")Modèle IronPDF:
var html = "<div style='position:absolute; left:50px; top:50px;'>Hello, World!</div>";
var pdf = renderer.RenderHtmlAsPdf(html);Dim html As String = "<div style='position:absolute; left:50px; top:50px;'>Hello, World!</div>"
Dim pdf = renderer.RenderHtmlAsPdf(html)Les deux bibliothèques utilisent un indexage 0-based (Pages[0] est la première page)—aucun changement nécessaire pour le code d'accès aux pages.
IronPDF ne nécessite pas d'instructions using pour la gestion de mémoire, simplifiant la structure du code :
// BitMiracle Docotic PDF- disposal required
using (var pdf = new PdfDocument("input.pdf"))
{
// operations
}
//IronPDF- disposal optional
var pdf = PdfDocument.FromFile("input.pdf");
// operations - no using statement neededImports BitMiracle.Docotic.Pdf
Using pdf As New PdfDocument("input.pdf")
' operations
End Using
Dim pdf = PdfDocument.FromFile("input.pdf")
' operations - no using statement neededLe module complémentaire HtmlToPdf de BitMiracle Docotic PDFnécessite des modèles asynchrones partout.IronPDF prend en charge les méthodes synchrones et asynchrones :
// Synchronous
var pdf = renderer.RenderHtmlAsPdf(html);
// Asynchronous
var pdf = await renderer.RenderHtmlAsPdfAsync(html);' Synchronous
Dim pdf = renderer.RenderHtmlAsPdf(html)
' Asynchronous
Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)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 ClassAprès avoir effectué la migration du code, vérifiez les points suivants :
La migration de BitMiracle Docotic PDFvers IronPDF élimine la complexité de la gestion de plusieurs packages complémentaires tout en offrant les mêmes capacités de rendu HTML basées sur Chromium. Le passage du dessin basé sur le canevas au positionnement HTML/CSS tire parti des compétences en développement web que la plupart des développeurs .NET possèdent déjà, ce qui se traduit par un code de génération de PDF plus facile à maintenir.
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.
