跳至页脚内容
.NET 帮助

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

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

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

什么是 CurlDotNet?

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

快速启动和安装

要开始使用,只需在项目目录中运行以下命令即可:

dotnet add package 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);
Imports CurlDotNet

' Simply copy-paste your shell command
Dim command As String = "curl -X GET https://api.github.com/users/jacob-mellor -H 'User-Agent: curl-dot-net'"
Dim result = Await Curl.ExecuteAsync(command)
Console.WriteLine(result.Body)
$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();
Dim response = Await Curl.GetAsync("https://api.github.com/users/ironsoftware") _
    .WithHeader("Authorization", "Bearer YOUR_TOKEN") _
    .WithHeader("X-API-Key", "12345") _
    .ExecuteAsync()
$vbLabelText   $csharpLabel

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

在 .NET Framework 中与 Iron Software 集成

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

场景:从 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;
Imports System.Threading.Tasks

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

' Execute the request
Dim result = Await Curl.ExecuteAsync(curlCmd)

' Extract the content (assumed to be HTML for this scenario)
Dim htmlContent As String = result.Body
$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");
Imports IronPdf

' Instantiate the renderer
Dim renderer As New ChromePdfRenderer()

' Convert the fetched HTML data to PDF
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

' Save the file to the output path
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

输出

使用 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;
Imports System

Dim testUrl As String = "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
Dim response = Await Curl.GetAsync(testUrl) ' Use Curl.GetAsync() for async HTTP GET

Dim jsonBody As String = response.Body
$vbLabelText   $csharpLabel

步骤 2:使用 IronXL 加载并导出到 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)}");
Imports IronXL
Imports Newtonsoft.Json
Imports System.IO

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

' 1. Deserialize the JSON string to a list of UserRecord objects
Console.WriteLine("Deserializing JSON data...")
Dim salesRecords = JsonConvert.DeserializeObject(Of List(Of 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 i As Integer = 0 To salesRecords.Count - 1
    Dim 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)
Next

' Save the Excel file
Dim filePath As String = "UserReport.xlsx"
workbook.SaveAs(filePath)

Console.WriteLine(vbCrLf & " Success! Excel report saved to: " & Path.GetFullPath(filePath))
$vbLabelText   $csharpLabel

输出 Excel 文件

使用 CurlDotNet 和 IronXL 创建的 Excel 文件

为什么要进行这种组合?

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

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

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 是 Iron Software 的首席技术官,也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者,他从公司成立之初就开始塑造公司的产品架构,与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司,为 NASA、特斯拉和全球政府机构提供服务。

Jacob 拥有曼彻斯特大学土木工程一级荣誉工程学士学位(BEng)(1998-2001 年)。他的旗舰产品 IronPDF 和 Iron Suite for .NET 库在全球的 NuGet 安装量已超过 3000 万次,其基础代码继续为全球使用的开发人员工具提供动力。Jacob 拥有 25 年的商业经验和 41 年的编码专业知识,他一直专注于推动企业级 C#、Java 和 Python PDF 技术的创新,同时指导下一代技术领导者。

钢铁支援团队

我们每周 5 天,每天 24 小时在线。
聊天
电子邮件
打电话给我