消息图标
跳至页脚内容
  1. IronPDF
  2. IronPDF博客
  3. 迁移指南
  4. 从 pdfmyurl 迁移到 IronPDF
迁移指南

如何用 C# 从 PDFmyURL 迁移到 IronPDF

Curtis Chau
Curtis Chau
已发布:

PDFmyURL 是一项基于云的 API 服务，旨在将 URL 和 HTML 内容转换为 PDF 文档。 该服务在外部服务器上处理所有转换，提供了一个直接的集成路径，只需最少的本地基础设施。 然而，对于处理敏感数据、需要离线功能或需要避免持续订阅成本的生产应用程序来说，这种依赖云的架构会带来很大的问题。

本指南提供了从PDFmyURL到IronPDF的完整迁移路径，为评估这一过渡的 .NET 专业开发人员提供了分步说明、代码比较和实用示例。

为什么要从PDFmyURL迁移

PDFmyURL 的云处理模式带来了开发团队必须考虑的几个挑战：

隐私和数据安全：您转换的每个文档都会传输到PDFmyURL的服务器并经过其服务器——敏感合同、财务报告和个人数据都在外部进行处理。

持续订阅费用：每月起价 39 美元，年费用超过 468 美元，且不拥有产品所有权。这种订阅模式意味着无论使用情况如何，都需要持续付费。

互联网依赖性：每次转换都需要网络连接。 应用程序不能离线或在网络中断时处理 PDF。

速率限制和节流：在高峰使用期间，API 调用可能会受到节流，这可能会影响应用程序的性能。

服务可用性：您的应用程序依赖于第三方服务在线且功能正常。

供应商锁定： API 变更可能会在未事先通知的情况下破坏您的集成，需要被动地更新代码。

IronPDF与 PDFmyURL：功能比较

了解架构差异有助于技术决策者评估迁移投资：

方面 PDFmyURL IronPDF
处理地点 外部服务器 本地（您的服务器）
类型 应用程序接口封装 .NET 库
身份验证 每次请求的 API 密钥 一次性许可证密钥
网络要求 每次转换 仅初始设置
定价模式 按月订购（39 美元以上） 提供永久许可证
费用限制 是（取决于计划） 无
数据隐私 外部发送的数据 数据保持本地化
HTML/CSS/JS 支持 符合 W3C 标准 完整的 Chromium 引擎
同步模式 要求（仅限异步） 同步和异步选项
PDF 操作 有限的 全套（合并、拆分、编辑）
使用案例 少量应用 大批量和企业

快速入门：PDFmyURL 到IronPDF的迁移

迁移工作可以通过以下基本步骤立即开始。

步骤 1：替换 NuGet 软件包

删除PDFmyURL软件包：

# RemovePDFmyURLpackages
dotnet remove package PdfMyUrl
dotnet remove package Pdfcrowd
# RemovePDFmyURLpackages
dotnet remove package PdfMyUrl
dotnet remove package Pdfcrowd
SHELL

安装 IronPDF：

# Install IronPDF
dotnet add package IronPdf
# Install IronPDF
dotnet add package IronPdf
SHELL

步骤 2：更新命名空间

用 IronPdf 替换PDFmyURL命名空间：

// Before: PDFmyURL
using PdfMyUrl;
using Pdfcrowd;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
// Before: PDFmyURL
using PdfMyUrl;
using Pdfcrowd;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
$vbLabelText   $csharpLabel

步骤 3：初始化许可证

在应用程序启动时添加许可证初始化：

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
$vbLabelText   $csharpLabel

代码迁移示例

将 URL 转换为 PDF

URL-to-PDF 操作演示了PDFmyURL和IronPDF之间基本的 API 差异。

PDFmyURL 方法：

// InstallPDFmyURLSDK
using System;
using Pdfcrowd;

class Example
{
    static void Main()
    {
        try
        {
            var client = new HtmlToPdfClient("username", "apikey");
            client.convertUrlToFile("https://example.com", "output.pdf");
        }
        catch(Error why)
        {
            Console.WriteLine("Error: " + why);
        }
    }
}
// InstallPDFmyURLSDK
using System;
using Pdfcrowd;

class Example
{
    static void Main()
    {
        try
        {
            var client = new HtmlToPdfClient("username", "apikey");
            client.convertUrlToFile("https://example.com", "output.pdf");
        }
        catch(Error why)
        {
            Console.WriteLine("Error: " + why);
        }
    }
}
$vbLabelText   $csharpLabel

IronPdf 方法：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Example
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Example
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

PDFmyURL 要求为每个转换请求创建一个带有用户名和 API 密钥凭证的HtmlToPdfClient，然后调用带有 URL 和输出路径的 convertUrlToFile() 。 整个操作必须用PDFmyURL的自定义 Error 类型的 try-catch 封装。

IronPDF 将此简化为三行：创建 ChromePdfRenderer, 调用 RenderUrlAsPdf(), 并使用内置的 SaveAs() 方法。 无需每次请求的证书--许可证在应用程序启动时设置一次。

有关高级 URL-to-PDF 场景，请参阅 URL to PDF 文档。

将HTML字符串转换为PDF

HTML 字符串转换清楚地显示了模式差异。

PDFmyURL 方法：

// InstallPDFmyURLSDK
using System;
using Pdfcrowd;

class Example
{
    static void Main()
    {
        try
        {
            var client = new HtmlToPdfClient("username", "apikey");
            string html = "<html><body><h1>Hello World</h1></body></html>";
            client.convertStringToFile(html, "output.pdf");
        }
        catch(Error why)
        {
            Console.WriteLine("Error: " + why);
        }
    }
}
// InstallPDFmyURLSDK
using System;
using Pdfcrowd;

class Example
{
    static void Main()
    {
        try
        {
            var client = new HtmlToPdfClient("username", "apikey");
            string html = "<html><body><h1>Hello World</h1></body></html>";
            client.convertStringToFile(html, "output.pdf");
        }
        catch(Error why)
        {
            Console.WriteLine("Error: " + why);
        }
    }
}
$vbLabelText   $csharpLabel

IronPdf 方法：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Example
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Example
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

PDFmyURL 使用 convertStringToFile() 将 HTML 内容发送到外部服务器进行处理。IronPDF的 RenderHtmlAsPdf() 使用 Chromium 渲染引擎在本地处理所有内容。

探索 HTML 至 PDF 转换指南，了解更多选项。

带页面设置的 HTML 文件转换

配置纸张大小、方向和页边距需要在每个库中采用不同的方法。

PDFmyURL 方法：

// InstallPDFmyURLSDK
using System;
using Pdfcrowd;

class Example
{
    static void Main()
    {
        try
        {
            var client = new HtmlToPdfClient("username", "apikey");
            client.setPageSize("A4");
            client.setOrientation("landscape");
            client.setMarginTop("10mm");
            client.convertFileToFile("input.html", "output.pdf");
        }
        catch(Error why)
        {
            Console.WriteLine("Error: " + why);
        }
    }
}
// InstallPDFmyURLSDK
using System;
using Pdfcrowd;

class Example
{
    static void Main()
    {
        try
        {
            var client = new HtmlToPdfClient("username", "apikey");
            client.setPageSize("A4");
            client.setOrientation("landscape");
            client.setMarginTop("10mm");
            client.convertFileToFile("input.html", "output.pdf");
        }
        catch(Error why)
        {
            Console.WriteLine("Error: " + why);
        }
    }
}
$vbLabelText   $csharpLabel

IronPdf 方法：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Example
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 10;
        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Example
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 10;
        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

PDFmyURL 使用带有字符串参数的设置器方法，如setPageSize("A4")和setMarginTop("10mm")。IronPDF通过 RenderingOptions 提供强类型属性，如 PdfPaperSize.A4 枚举和以毫米为单位的页边距整数值。

PDFmyURLAPI 到IronPDF映射参考

这种映射通过显示直接的 API 对应关系来加速迁移：

核心类

PDFmyURL IronPDF 备注
HtmlToPdfClient|ChromePdfRenderer` 主要转换类
PdfMyUrlClient ChromePdfRenderer 替代客户端类
API 响应对象 PDF 文档 结果 PDF 对象

方法

PDFmyURL IronPDF 备注
client.convertUrlToFile(url, file) renderer.RenderUrlAsPdf(url).SaveAs(file) URL 至 PDF
client.convertStringToFile(html, file) renderer.RenderHtmlAsPdf(html).SaveAs(file) HTML 字符串到 PDF
client.convertFileToFile（输入，输出） renderer.RenderHtmlFileAsPdf(input).SaveAs(output) 文件到文件
response.GetBytes() pdf.BinaryData 获取原始字节
response.GetStream() pdf.Stream 以流形式获取

配置选项

PDFmyURL （setXxx 方法） IronPdf (渲染选项) 备注
setPageSize("A4") .PaperSize = PdfPaperSize.A4 纸张大小
setPageSize("Letter") .PaperSize = PdfPaperSize.Letter 美国信函
setOrientation("横向") .PaperOrientation = PdfPaperOrientation.Landscape 定位
setOrientation("portrait") .PaperOrientation = PdfPaperOrientation.Portrait 肖像
setMarginTop("10mm") .MarginTop = 10 顶边距（毫米）
setMarginBottom("10mm") .MarginBottom = 10 底边距（毫米）
setMarginLeft("10mm") .MarginLeft = 10 左页边距（毫米）
setMarginRight("10mm") .MarginRight = 10 右边距（毫米）
setHeaderHtml(html) .HtmlHeader = new HtmlHeaderFooter { HtmlFragment = html }. 页眉
setFooterHtml(html) .HtmlFooter = new HtmlHeaderFooter { HtmlFragment = html }. 页脚
setJavascriptDelay(500) .RenderDelay = 500. JS 等待时间（毫秒）
setDisableJavascript(true) .EnableJavaScript = false. 禁用 JS
setUsePrintMedia(true) .CssMediaType = PdfCssMediaType.Print. 打印 CSS

身份验证比较

PDFmyURL IronPDF
new HtmlToPdfClient（"username", "apikey"） IronPdf.License.LicenseKey = "LICENSE-KEY"
每次请求的 API 密钥 启动时一次性
每次通话都需要 全球设置一次

常见迁移问题和解决方案

问题 1：API 密钥与许可证密钥

PDFmyURL：每次转换请求都需要证书。

解决方案：在应用程序启动时设置一次IronPDF许可证：

// PDFmyURL: API key per request
var client = new HtmlToPdfClient("username", "apikey");

// IronPDF: One-time license at startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Set once, typically in Program.cs or Startup.cs
// PDFmyURL: API key per request
var client = new HtmlToPdfClient("username", "apikey");

// IronPDF: One-time license at startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Set once, typically in Program.cs or Startup.cs
$vbLabelText   $csharpLabel

问题 2：页眉/页脚中的占位符语法

PDFmyURL： 使用 {page_number} 和 {total_pages} 占位符。

解决方案：更新为IronPDF的占位符格式：

// PDFmyURL: "Page {page_number} of {total_pages}"
// IronPDF: "Page {page} of {total-pages}"
// PDFmyURL: "Page {page_number} of {total_pages}"
// IronPDF: "Page {page} of {total-pages}"
$vbLabelText   $csharpLabel

第 3 期：异步模式

PDFmyURL：需要异步/等待模式。

解决方案：IronPDF默认为同步； 如有需要，请对 async 进行包装：

// PDFmyURL: Native async
var response = await client.ConvertUrlAsync(url);

// IronPDF: Sync by default, wrap for async
var pdf = await Task.Run(() => renderer.RenderUrlAsPdf(url));
// PDFmyURL: Native async
var response = await client.ConvertUrlAsync(url);

// IronPDF: Sync by default, wrap for async
var pdf = await Task.Run(() => renderer.RenderUrlAsPdf(url));
$vbLabelText   $csharpLabel

问题 4：错误处理

PDFmyURL：使用自定义 Pdfcrowd.Error 异常类型。

解决方案：更新IronPDF异常的捕获块：

// PDFmyURL: Pdfcrowd.Error
catch (Pdfcrowd.Error e) { ... }

// IronPDF: Standard exceptions
catch (IronPdf.Exceptions.IronPdfRenderingException e) { ... }
// PDFmyURL: Pdfcrowd.Error
catch (Pdfcrowd.Error e) { ... }

// IronPDF: Standard exceptions
catch (IronPdf.Exceptions.IronPdfRenderingException e) { ... }
$vbLabelText   $csharpLabel

第 5 期：配置模式

PDFmyURL：使用带有字符串值的设置器方法。

解决方案：使用强类型的 RenderingOptions 属性：

// PDFmyURL: Setter methods
client.setPageSize("A4");
client.setOrientation("landscape");

// IronPDF: Properties with enums
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
// PDFmyURL: Setter methods
client.setPageSize("A4");
client.setOrientation("landscape");

// IronPDF: Properties with enums
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
$vbLabelText   $csharpLabel

PDFmyURL迁移清单

迁移前任务

审核您的代码库，以确定PDFmyURL的所有使用情况：

# FindPDFmyURLusage
grep -r "PdfMyUrl\|Pdfcrowd\|HtmlToPdfClient" --include="*.cs" .

# Find API key references
grep -r "apikey\|api-key\|api_key" --include="*.cs" --include="*.json" --include="*.config" .

# Find placeholder patterns to migrate
grep -r "{page_number}\|{total_pages}" --include="*.cs" .
# FindPDFmyURLusage
grep -r "PdfMyUrl\|Pdfcrowd\|HtmlToPdfClient" --include="*.cs" .

# Find API key references
grep -r "apikey\|api-key\|api_key" --include="*.cs" --include="*.json" --include="*.config" .

# Find placeholder patterns to migrate
grep -r "{page_number}\|{total_pages}" --include="*.cs" .
SHELL

记录当前使用的配置选项。 使用环境变量规划许可证密钥存储。

代码更新任务

1.删除 PDFmyURL/Pdfcrowd NuGet 软件包 2.安装 IronPdf NuGet 软件包 3.更新所有命名空间导入 4.用 IronPdf 许可证密钥替代 API 密钥验证 5.将设置器方法转换为 RenderingOptions 属性 6.更新页眉/页脚中的占位符语法（{page_number} → {page}, {total_pages} → {total-pages}) 7.更新 IronPdf 异常类型的错误处理代码 8.在启动时添加 IronPdf 许可证初始化功能

迁移后测试

迁移后，验证这些方面：

  • 测试 PDF 输出质量是否符合预期
  • 验证异步模式是否正常工作
  • 将渲染保真度与以前的输出进行比较
  • 测试所有模板变体是否能正确呈现
  • 验证页面设置（大小、方向、页边距）
  • 如果部署到 Linux 服务器，请安装 Linux 依赖项

迁移到IronPDF的主要优势

从PDFmyURL迁移到IronPDF有几个关键优势：

完全隐私：文档绝不会离开您的服务器。 所有处理都在本地进行，消除了敏感内容的数据安全顾虑。

一次性费用：永久授权选项免除定期订阅费用。 无论使用量多少，都不再需要每月付款。

离线功能：完成初始设置后，无需网络连接即可工作。网络中断不会影响 PDF 生成。

无速率限制：处理无限量文档，无需担心限速问题。

更低的延迟：没有网络开销意味着更快的转换速度，尤其适用于高容量应用。

完全控制：您控制处理环境，而不是第三方服务。

现代 Chromium 引擎：完全支持 CSS3 和 JavaScript，采用与 Chrome 浏览器相同的渲染引擎。

积极开发：随着 .NET 10 和 C# 14 的普及，IronPDF 将持续更新，确保与当前和未来的 .NET 版本兼容。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

相关文章

30天试用 → 完整产品。无限制。无卡。 免费试用