跳至页脚内容
  1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. Curl Dotnet
.NET 帮助

架起 CLI 简洁性与 .NET 的桥梁：使用 IronPDF for .NET 的 Curl DotNet

Jacob Mellor，Team Iron 的首席技术官
Jacob Mellor
已更新:

对于在快速命令行工具脚本和健壮的 .NET 代码之间游刃有余的开发人员来说，摩擦往往在于如何在 C# 中将有效的 cURL 命令翻译成正确的 HTTP 请求。 Jacob Mellor 通过 CurlDotNet弥补了这一差距，该库的创建是为了将人们熟悉的 cURL 带入 .NET 生态系统。

通过将此工具与 Iron Software 产品（如 IronPdf 或 IronXL ）相结合，您可以构建强大的管道，通过复杂的 API 调用获取数据并立即生成专业报告。 在本文中，我们将举例说明这些工具在哪些方面可以协同工作，使您的项目更上一层楼。

什么是 CurlDotNet？

CurlDotNet 是行业标准 curl 工具的纯 C# .NET 实现。 与依赖本地依赖关系或 libcurl 的包装器不同，该库提供 100% 受管理的解决方案，完全支持 Windows、Linux、macOS 等系统。 它确保了与标准客户端相同的行为，让您只需将 API 文档中命令的 bash 副本直接粘贴到代码中即可。

快速启动和安装

要开始翻译，只需在项目目录中运行以下命令即可：

dotnet 添加包 curldotnet

这将安装 CurlDotNet 软件包，让您可以访问处理网络请求的即用配方，而无需 HttpClient 配置的开销。

使用 Curl-Dot-Net Curl 命令

该库擅长解析字符串值命令。 如果您从 GitHub API 页面或内部文档中获得了有效的 curl https 字符串，可以直接执行。

using CurlDotNet;

// Simply copy-paste your shell command
var command = "curl -X GET https://api.github.com/users/jacob-mellor -H 'User-Agent: curl-dot-net'";
var result = await Curl.ExecuteAsync(command);
Console.WriteLine(result.Body);
using CurlDotNet;

// Simply copy-paste your shell command
var command = "curl -X GET https://api.github.com/users/jacob-mellor -H 'User-Agent: curl-dot-net'";
var result = await Curl.ExecuteAsync(command);
Console.WriteLine(result.Body);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

.NET 代码 Curl DotNet 输出。

！我们的第一个 Curl DotNet 命令的输出。

对于那些喜欢结构化方法的人，流畅构建器提供了一个简洁的 API 来设置头文件、curl 选项和访问令牌。

var response = await Curl.GetAsync("https://api.github.com/users/ironsoftware")
    .WithHeader("Authorization", "Bearer YOUR_TOKEN")
    .WithHeader("X-API-Key", "12345")
    .ExecuteAsync();
var response = await Curl.GetAsync("https://api.github.com/users/ironsoftware")
    .WithHeader("Authorization", "Bearer YOUR_TOKEN")
    .WithHeader("X-API-Key", "12345")
    .ExecuteAsync();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这种灵活性在内部处理 TLS 握手机制、速率限制和错误处理，模仿 curl 可执行文件的默认行为。

在 .NET Framework 中与 IronSoftware 集成。

当您将 CurlDotNet 的输出导入 Iron Software 工具时，真正的威力就会释放出来。 由于 CurlDotNet 负责处理传输层（获取 JSON、文件或 HTML），因此 IronSoftware 产品可以专注于处理这些内容。

场景：从 API 数据生成 PDF 报告

想象一下，您需要从一个安全的 URL 下载用户数据并生成 PDF 报告。 应用程序接口需要特定的 bash 签名，使用 HttpClient 很难复制，但使用 curl 命令却很容易。

步骤 1：使用 Curl-Dot-Net 获取数据

// Define the curl command string with all necessary headers (here we use an example test website)
string curlCmd = "curl https://www.w3.org/TR/html4/ -H 'X-API-Key: secure_key'";

// Execute the request
var result = await Curl.ExecuteAsync(curlCmd);

// Extract the content (assumed to be HTML for this scenario)
string htmlContent = result.Body;
// Define the curl command string with all necessary headers (here we use an example test website)
string curlCmd = "curl https://www.w3.org/TR/html4/ -H 'X-API-Key: secure_key'";

// Execute the request
var result = await Curl.ExecuteAsync(curlCmd);

// Extract the content (assumed to be HTML for this scenario)
string htmlContent = result.Body;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

第 2 步：使用 IronPDF 生成 PDF.

IronPDF是一个功能强大的库，旨在将HTML、CSS、JavaScript和图像呈现为高保真 PDF 文档。 它完全支持现代网络标准，包括添加页眉、页脚和设置特定渲染选项等功能。

using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert the fetched HTML data to PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the file to the output path
pdf.SaveAs("output.pdf");
using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert the fetched HTML data to PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the file to the output path
pdf.SaveAs("output.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

输出

!a href="/static-assets/pdf/blog/curl-dotnet-guide/curl-dotnet-guide-2.webp">使用 CurlDotNet 和 IronPDF 转换为 PDF 的测试网站。

场景：将 JSON 导出到 Excel.

如果您的应用程序消耗 JSON feed，您可以使用 CurlDotNet 的测试功能获取它，并使用 IronXL 导出它。

步骤 1：使用 Curl-Dot-Net 抓取 JSON 数据

我们使用 Fluent 生成器生成简洁的 .NET 代码，以获取 JSON feed：

string testUrl = "https://jsonplaceholder.typicode.com/users";

Console.WriteLine($"Executing HTTP request to fetch JSON from: {testUrl}");
// Replace the CurlDotNet fluent builder usage with the correct async method
var response = await Curl.GetAsync(testUrl); // Use Curl.GetAsync() for async HTTP GET

string jsonBody = response.Body;
string testUrl = "https://jsonplaceholder.typicode.com/users";

Console.WriteLine($"Executing HTTP request to fetch JSON from: {testUrl}");
// Replace the CurlDotNet fluent builder usage with the correct async method
var response = await Curl.GetAsync(testUrl); // Use Curl.GetAsync() for async HTTP GET

string jsonBody = response.Body;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

步骤 2：使用 IronXL.Excel 加载并导出到 Excel.

IronXL是一个全面的.NET库，设计用于处理读取、编写和操作Excel文件格式（.xlsx、.xls、.csv）的所有方面。 最重要的是，它无需在服务器或客户端机器上安装 Microsoft Office，因此非常适合跨平台 Linux 和 CI CD 环境。 主要功能包括全面支持创建图表、应用公式和单元格样式。

现在原始的 JSON 数据已经变成了字符串，可以使用 IronXL 对其进行解析并构建电子表格。

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
 var sheet = workbook.CreateWorkSheet("User Data");

 // 1. Deserialize the JSON string to a list of UserRecord objects
 Console.WriteLine("Deserializing JSON data...");
 var salesRecords = JsonConvert.DeserializeObject<List<UserRecord>>(jsonBody);

 // 2. Insert the data into the sheet using IronXL's SetCellValue method
 Console.WriteLine("Inserting data into Excel using IronXL...");

 // Write headers
 sheet.SetCellValue(0, 0, "id");
 sheet.SetCellValue(0, 1, "name");
 sheet.SetCellValue(0, 2, "username");
 sheet.SetCellValue(0, 3, "email");

 // Write data rows
 for (int i = 0; i < salesRecords.Count; i++)
 {
     var record = salesRecords[i];
     sheet.SetCellValue(i + 1, 0, record.id);
     sheet.SetCellValue(i + 1, 1, record.name);
     sheet.SetCellValue(i + 1, 2, record.username);
     sheet.SetCellValue(i + 1, 3, record.email);
 }

 // Save the Excel file
 string filePath = "UserReport.xlsx";
 workbook.SaveAs(filePath);

 Console.WriteLine($"\n Success! Excel report saved to: {Path.GetFullPath(filePath)}");
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
 var sheet = workbook.CreateWorkSheet("User Data");

 // 1. Deserialize the JSON string to a list of UserRecord objects
 Console.WriteLine("Deserializing JSON data...");
 var salesRecords = JsonConvert.DeserializeObject<List<UserRecord>>(jsonBody);

 // 2. Insert the data into the sheet using IronXL's SetCellValue method
 Console.WriteLine("Inserting data into Excel using IronXL...");

 // Write headers
 sheet.SetCellValue(0, 0, "id");
 sheet.SetCellValue(0, 1, "name");
 sheet.SetCellValue(0, 2, "username");
 sheet.SetCellValue(0, 3, "email");

 // Write data rows
 for (int i = 0; i < salesRecords.Count; i++)
 {
     var record = salesRecords[i];
     sheet.SetCellValue(i + 1, 0, record.id);
     sheet.SetCellValue(i + 1, 1, record.name);
     sheet.SetCellValue(i + 1, 2, record.username);
     sheet.SetCellValue(i + 1, 3, record.email);
 }

 // Save the Excel file
 string filePath = "UserReport.xlsx";
 workbook.SaveAs(filePath);

 Console.WriteLine($"\n Success! Excel report saved to: {Path.GetFullPath(filePath)}");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

输出 Excel 文件

!a href="/static-assets/pdf/blog/curl-dotnet-guide/curl-dotnet-guide-3.webp"> 使用 CurlDotNet 和 IronExcel 创建的 Excel 文件。

为什么要进行这种组合？

1.跨平台一致性：CurlDotNet和IronSoftware产品均支持 Windows、Linux 和 macOS。 这对于在 Microsoft Azure 或 AWS Lambda 等运行环境中运行的 CI CD 管道至关重要。

2.代码生成：开发人员经常会收到 bash 或 shell 格式的代码生成片段。 curl-dot-net允许您直接使用这些片段，而IronSoftware则负责处理文档的繁重工作。

3.无本地依赖性：由于 CurlDotNet 是纯 C# 实现，因此您可以避免在不同操作系统版本上链接外部 C++ 库或 libcurl 二进制文件所带来的常见问题。

结论

Jacob Mellor 为 DotNet 社区提供了一个重要的工具。 通过允许开发人员在.NET Framework和Core应用程序中使用熟悉的curl选项，CurlDotNet简化了http请求过程。 与 Iron Software 搭配使用时，您可以创建一个无缝的工作流程：利用 curl 的精确性获取数据，并利用 IronPDF 或 IronXL 的强大功能处理数据。

如果您遇到问题，请务必在GitHub页面上报告错误，以帮助改善对每位用户的支持。

常见问题解答

什么是 CurlDotNet？

CurlDotNet 是 Jacob Mellor 创建的一个库，旨在将 cURL 的功能引入 .NET 生态系统，使开发人员能够轻松地将 cURL 命令翻译成 .NET 代码。

CurlDotNet 如何帮助开发人员？

CurlDotNet 通过简化 C# 中将 cURL 命令行操作翻译为 HTTP 请求的过程来帮助开发人员，使他们更容易将命令行工具脚本集成到强大的 .NET 应用程序中。

CurlDotNet 能解决什么问题？

CurlDotNet 解决了开发人员在尝试将工作中的 cURL 命令转换为 C# 中正确的 HTTP 请求时所面临的摩擦问题。它为那些习惯于 cURL 简洁性的人提供了一种熟悉的方法。

CurlDotNet 可以与 IronPDF 一起使用吗？

是的，CurlDotNet 可与 IronPDF 一起使用，以提高 HTTP 请求的便捷性，作为 .NET 应用程序中 PDF 生成工作流的一部分。

CurlDotNet 适合初学者吗？

是的，CurlDotNet 适合初学者，因为它提供了一个熟悉的命令行式界面，可以简化那些刚接触 .NET 和 HTTP 请求的人的学习曲线。

使用 CurlDotNet 和 IronPdf 有什么好处？

将 CurlDotNet 与 IronPDF 结合使用，可以让开发人员在生成 PDF 的同时简化 HTTP 请求，提高效率并发挥两种工具的优势。

从哪里可以了解有关 CurlDotNet 的更多信息？

您可以访问 Jacob Mellor 在 Medium 上发表的文章，详细了解 CurlDotNet 库如何在 cURL 命令和 .NET 代码之间架起桥梁。

Jacob Mellor，Team Iron 的首席技术官
Jacob Mellor
  立即与工程团队聊天
首席技术官

Jacob Mellor 是 Iron Software 的首席技术官，是 C# PDF 技术的先锋工程师。作为 Iron Software 核心代码库的原始开发者，自公司成立以来，他就塑造了公司的产品架构，并与首席执行官 Cameron Rimington 一起将其转变成一家公司，拥有50多人，服务于 NASA、特斯拉和全球政府机构。

Jacob 拥有曼彻斯特大学 (1998-2001) 的一级荣誉土木工程学士学位。1999 年在伦敦创办了自己的第一家软件公司，并于 2005 年创建了他的第一个 .NET 组件后，他专注于解决微软生态系统中的复杂问题。

他的旗舰 IronPDF 和 Iron Suite .NET 库在全球已获得超过 3000 万次的 NuGet 安装，其基础代码继续为全球使用的开发者工具提供支持。拥有 25 年商业经验和 41 年编程经验的 Jacob 仍专注于推动企业级 C#、Java 和 Python PDF 技术的创新，同时指导下一代技术领导者。

相关文章

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