using IronPdf; // Disable local disk access or cross-origin requests Installation.EnableWebSecurity = true; // Instantiate Renderer var renderer = new ChromePdfRenderer(); // Create a PDF from a HTML string using C# var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>"); // Export to a file or Stream pdf.SaveAs("output.pdf"); // Advanced Example with HTML Assets // Load external html assets: Images, CSS and JavaScript. // An optional BasePath 'C:\site\assets\' is set as the file location to load assets from var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\"); myAdvancedPdf.SaveAs("html-with-assets.pdf");

迁移指南

如何用 C# 从 BitMiracle Docotic PDF 迁移到 IronPDF

Curtis Chau

已更新:一月 7, 2026

从BitMiracle Docotic PDF迁移到 IronPDF：完整的 C# 迁移指南

BitMiracle Docotic PDF 是一个广受好评的 .NET PDF 库，以其 100% 的托管代码架构和广泛的 PDF 编程操作能力而闻名。然而，其模块化附加结构--需要单独的软件包来实现 HTML 到 PDF 的转换、布局功能和其他功能--增加了项目管理和许可的复杂性。本综合指南提供了从BitMiracle Docotic PDF逐步迁移到IronPDF的路径--IronPDF 是一个统一的 .NET PDF 库，内置基于 Chromium 的 HTML 渲染功能，所有功能都包含在一个 NuGet 包中。

为什么要从BitMiracle Docotic PDF迁移到 IronPDF？虽然BitMiracle Docotic PDF提供了强大的 PDF 操作功能，但有几个因素促使开发团队寻求具有更精简架构的替代产品。 ### 软件包架构比较 BitMiracle Docotic PDF 采用模块化附加方法，需要多个软件包才能实现全部功能： |方面|BitMiracle Docotic PDF|IronPDF| |--------|-------------|---------| |HTML-to-PDF|需要单独的插件 (HtmlToPdf)|内置核心功能| |软件包结构|核心 + 多个附加组件|单个 NuGet 软件包| |许可模式|按次许可|所有功能包括| |API 复杂性|每个附加组件都有独立的命名空间|统一 API| |HTML 引擎|Chromium （通过附加组件）|Chromium （内置）| |社区规模|较小|规模更大、资源更多| |文档|技术参考|广泛的教程| ### 功能对等这两个库都支持全面的 PDF 功能： | 特征 |BitMiracle Docotic PDF|IronPDF| |---------|-------------|---------| |从零开始创建 PDF|✅|✅| |HTML 至 PDF|✅（需要插件）|✅（内置）| |URL 至 PDF|✅（需要插件）|✅（内置）| |PDF 操作|✅|✅| |文本提取|✅|✅| |合并/拆分|✅|✅| |数字签名|✅|✅| |加密|✅|✅| |表格填写|✅|✅| |符合 PDF/A 标准|✅|✅| ### 方法上的主要差异 BitMiracle Docotic PDF 使用基于画布的绘图和坐标定位（`canvas.DrawString(x, y, text)`），而IronPDF则利用 HTML/CSS 进行布局和定位。这代表了一种模式的转变，简化了熟悉网络技术的开发人员的内容创建。 ## 迁移前准备 ### 前提条件确保您的环境符合这些要求： - .NET Framework 4.6.2+ 或 .NET Core 3.1 / .NET 5-9 - Visual Studio 2019+ 或带有 C# 扩展的 VS Code - 访问 NuGet 包管理器 -IronPDF许可证密钥（可在[ironpdf.com](https://ironpdf.com/licensing/)免费试用） ### 审计BitMiracle Docotic PDF的使用情况在解决方案目录中运行这些命令，以识别所有 Docotic.Pdf 引用： ```bash # 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" . ``` ### 值得期待的重大变化 |变更|BitMiracle Docotic PDF|IronPDF|影响| |--------|-------------|---------|--------| |HTML 渲染|需要 HtmlToPdf 附加组件| 内置 |删除附加软件包| |页面索引|基于 0 (`Pages[0]`)|基于 0 (`Pages[0]`)|无需改动| |坐标系|左下方原点|HTML/CSS 流程|使用 CSS 进行定位| |画布绘图|<代码>PdfCanvas.DrawText()page.GetText()pdf.ExtractAllText()新建 PdfDocument(path)PdfDocument.FromFile(路径)document.Save(路径)pdf.SaveAs(路径)new PdfDocument()new PdfDocument()新建 PdfDocument(path)PdfDocument.FromFile(路径)PdfDocument.Load(stream)PdfDocument.FromStream(流)PdfDocument.Load(bytes)PdfDocument.FromBinaryData(字节)document.Save(路径)pdf.SaveAs(路径)document.PageCountpdf.PageCountdocument.Dispose()HtmlConverter.Create(html).ToPdf()renderer.RenderHtmlAsPdf(html)HtmlConverter.Create(new Uri(filePath)).ToPdf()renderer.RenderHtmlFileAsPdf(path)HtmlConverter.Create(new Uri(url)).ToPdf()renderer.RenderUrlAsPdf(url)options.PageSize = PageSize.A4renderer.RenderingOptions.PaperSize = PdfPaperSize.A4options.PageMargins = new Margins(20)renderer.RenderingOptions.MarginTop = 20doc1.Append(doc2)PdfDocument.Merge(pdf1, pdf2)document.CopyPage(index)到新文档|<代码>pdf.CopyPages（start, end）

Hello World

This isHTML 至 PDFconversion.

Hello World

This isHTML 至 PDFconversion.

{ pdf1, pdf2 }); merged.SaveAs("merged.pdf"); Console.WriteLine("PDFs merged successfully"); } } ``` IronPDF 的静态 `Merge` 方法可直接接受多个文档，与迭代 `Append` 模式相比，提供了一个更简洁的 API。有关更多选项，请参阅 [IronPDF合并文档](https://ironpdf.com/how-to/merge-split-pdfs/)。 ### 文本提取 **BitMiracle Docotic PDF 实现：** ```csharp // NuGet: Install-Package 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); } } } ``` **IronPDF 实现：** ```csharp // 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); } } ``` IronPDF 将文本提取从多行循环减少到单个方法调用。有关更多提取选项，请参阅 [文本提取文档](https://ironpdf.com/how-to/pdf-text-extraction/)。 ### 密码保护和加密 **IronPDF 实现：** ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf("

Confidential Document

"); // Set security pdf.SecuritySettings.UserPassword = "userPassword"; pdf.SecuritySettings.OwnerPassword = "ownerPassword"; pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights; pdf.SecuritySettings.AllowUserCopyPasteContent = false; pdf.SaveAs("protected.pdf"); ``` 有关全面的安全选项，请参阅 [加密文档](https://ironpdf.com/how-to/pdf-encryption-and-decryption/)。 ### 页眉和页脚 **IronPDF 实现：** ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter { HtmlFragment = @"

Company Header - Confidential

", DrawDividerLine = true, MaxHeight = 30 }; renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter { HtmlFragment = @"

Page {page} of {total-pages}

", DrawDividerLine = true, MaxHeight = 25 }; var pdf = renderer.RenderHtmlAsPdf("

Document Content

"); pdf.SaveAs("with_headers.pdf"); ``` IronPdf 支持占位符标记，如用于动态页码的 `{page}` 和 `{total-pages}` 。有关更多选项，请参阅[页眉和页脚文档](https://ironpdf.com/how-to/headers-and-footers/)。 ## 关键迁移说明 ### 画布到 HTML 的范式转变 BitMiracle Docotic PDF 基于画布的绘图方法必须通过 CSS 定位转换为 HTML： **BitMiracle Docotic PDF 模式：** ```csharp var canvas = pdfPage.Canvas; canvas.DrawString(50, 50, "Hello, World!"); ``` **IronPdf模式：** ```csharp var html = "

Hello, World!

"; var pdf = renderer.RenderHtmlAsPdf(html); ``` ### 同页索引这两个库都使用基于 0 的索引（`Pages[0]` 是第一页）--无需更改页面访问代码。 ### 无需处理 IronPdf 不需要 `using` 语句进行内存管理，从而简化了代码结构： ```csharp //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 needed ``` ### 同步支持 BitMiracle Docotic PDF 的 HtmlToPdf 附加组件要求处处采用异步模式。IronPDF支持同步和异步方法： ```csharp // Synchronous var pdf = renderer.RenderHtmlAsPdf(html); // Asynchronous var pdf = await renderer.RenderHtmlAsPdfAsync(html); ``` ## ASP.NET Core 集成 **IronPdf模式：** ```csharp [ApiController] [Route("[controller]")] public class PdfController : ControllerBase { [HttpGet("generate")] public IActionResult GeneratePdf() { var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf("

Report

"); return File(pdf.BinaryData, "application/pdf", "report.pdf"); } [HttpGet("generate-async")] public async TaskGeneratePdfAsync() { var renderer = new ChromePdfRenderer(); var pdf = await renderer.RenderHtmlAsPdfAsync("

Report

"); return File(pdf.Stream, "application/pdf", "report.pdf"); } } ``` ## 迁移后核对表完成代码迁移后，请验证以下内容： - [ ] 运行所有单元测试以验证 PDF 生成工作正常 - [ ] 比较 PDF 输出质量（IronPDF 的 Chromium 引擎渲染效果可能略有不同--通常更好） - [ ] 验证文本提取的准确性 - [ ] 测试表格填写功能 - [如果适用，验证数字签名 - [ ] 批量操作性能测试 - [ ] 在所有目标环境中进行测试 - [更新 CI/CD 管道 - [ ] 删除 Docotic.Pdf 许可证文件 ## 未来保护您的 PDF 基础架构随着 .NET 10 即将推出，C# 14 也将引入新的语言特性，选择具有统一架构的 PDF 库可以简化依赖性管理，并确保功能的一致性。 IronPdf 的单包方法意味着当项目延伸到 2025 年和 2026 年时，您无需跟踪多个附加版本的兼容性。 ## 其他资源 - [IronPDF文档](https://ironpdf.com/docs/) - [HTML转PDF教程](https://ironpdf.com/tutorials/) - [API Reference](https://ironpdf.com/object-reference/api/) - [NuGet软件包](https://www.nuget.org/packages/IronPdf/) - [许可选项](https://ironpdf.com/licensing/) --- 从BitMiracle Docotic PDF迁移到IronPDF可以消除管理多个附加软件包的复杂性，同时提供相同的基于 Chromium 的 HTML 渲染功能。从基于画布的绘图过渡到 HTML/CSS 定位，利用了大多数 .NET 开发人员已经掌握的网络开发技能，从而使 PDF 生成代码更具可维护性。