使用 IRON SUITE

Curl DotNet：为.NET 运行时带来 Curl 超强功能

已发布:

对于每个 .NET 开发人员来说，这样的场景再熟悉不过了：您正在阅读一个新 API 的文档，而提供者给了您一个 curl 命令来测试一个端点。 您盯着命令行工具语法，叹了口气，然后开始将其翻译成 C# 中新的 HttpClient 实例的繁琐过程。

您必须手动映射标题，确保正文的字符串值编码正确，处理用户代理，并希望您没有遗漏默许默认值。 这种手动 bash 复制和翻译过程很容易出错。 缺少一个标头，您的 HTTP 请求就会失败。

输入 CurlDotNet。 由 Iron Software 的首席技术官 Jacob Mellor 创建的这个 .NET 库完全改变了工作流程。 它允许你将curl命令直接粘贴到代码中，并以与终端相同的方式执行。

什么是 Curl DotNet？

CurlDotNet 是 curl CLI 工具的纯 .NET 实现。 与其他封装不同，该库没有本地依赖关系（如 libcurl.dll）。 它完全由托管代码构建，这意味着它可以在 Windows、Linux 和 macOS 上无缝运行，无需复杂的设置。

无论您是在.NET Core中开发网络应用程序，还是在控制台应用程序或CI管道中工作，CurlDotNet都能为.NET运行时带来真正的curl语义。

主要功能

  • 零翻译：将 curl HTTPS 命令直接粘贴到 C# 源代码中。

  • 跨平台：全面支持 Windows、Linux、MacOS 等操作系统。

  • 类型安全：在依赖注入场景中使用流畅构建器的选项。

  • 可观察性：内置支持发出结构化事件以记录日志。

入门：安装和运行

首先，您需要通过软件包管理器安装 curldotnet 软件包。 您可以在发布说明中找到最新版本，或者直接运行：

dotnet 添加软件包 CurlDotNet

安装后，您可以立即执行 curl 调用。

字符串 API：粘贴和转到 Curl 命令

这种方法非常适合健康检查、支持代理或快速原型开发。 您只需以字符串形式传递 curl 命令即可。

using CurlDotNet;

// Simply paste the command string
var response = await Curl.ExecuteAsync("curl https://api.github.com/users/octocat");

// Access the data
Console.WriteLine(response.Body);
using CurlDotNet;

// Simply paste the command string
var response = await Curl.ExecuteAsync("curl https://api.github.com/users/octocat");

// Access the data
Console.WriteLine(response.Body);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

利用环境变量使用 Fluent 生成器。

对于需要通过环境变量处理敏感数据或需要更简洁架构的生产应用程序，流畅构建器是理想之选。 您可以为标题指定一个字符串名称，也可以明确设置文件路径。

var response = await Curl.GetAsync("https://api.example.com/data")
    .WithHeader("Authorization", "Bearer " + Environment.GetEnvironmentVariable("API_KEY"))
    .WithTimeout(TimeSpan.FromSeconds(30))
    .ExecuteAsync();
var response = await Curl.GetAsync("https://api.example.com/data")
    .WithHeader("Authorization", "Bearer " + Environment.GetEnvironmentVariable("API_KEY"))
    .WithTimeout(TimeSpan.FromSeconds(30))
    .ExecuteAsync();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Iron Software 连接：真实世界的集成

CurlDotNet由 Iron Software 赞助，该公司致力于打造能为开发人员解决最棘手问题的工具。 Jacob Mellor 创建 CurlDotNet 的理念与 Iron Software Suite 的理念相同：开发人员的体验是第一位的。

当与 Iron Software 产品结合使用时，CurlDotNet 的真正威力就会释放出来。 您可以使用 Curl 处理复杂的传输层（处理代理、传统 auth 或特定 curl http 怪癖），使用 Iron 库处理繁重的文档处理工作。

示例 1：使用 IronPDF 安全下载和编辑 PDF 文件

IronPDF

IronPDF 是在 .NET 中生成完美像素 PDF 的行业标准。 IronPDF 呈现 HTML、CSS和JavaScript，与其他在现代网络标准方面苦苦挣扎的库不同，IronPDF 与 Chrome 浏览器完全一致。 它是一个完整的解决方案：您可以从HTML字符串或文件生成新文档，编辑现有PDF文件，合并文档，以及应用安全功能，如水印和加密，而无需外部依赖性或在服务器上安装 Adobe Acrobat。

想象一下，您需要从一个需要复杂 curl 标志（如忽略 SSL 错误或特定报头排列）的传统内部系统下载生成的发票，然后使用 IronPDF 对其进行 watermark 处理。

将请求翻译成 HttpClient 可能需要数小时的调试时间。 使用 CurlDotNet，您可以粘贴命令，获取字节，然后将其交给 IronPdf。

using CurlDotNet;
using IronPdf;

// 1. Use CurlDotNet to handle the complex transport
// We use -k to allow insecure SSL (common in legacy internal apps)
var curlCommand = "curl -k https://internal-billing.local/invoice/1234 -H 'X-Dept: Sales'";
var response = await Curl.ExecuteAsync(curlCommand);

if (response.IsSuccess)
{
    // 2. Pass the raw bytes directly to IronPDF
    // IronPDF renders the PDF from the downloaded data
    var pdfDocument = PdfDocument.FromPdf(response.BodyBytes);

    // 3. Apply a watermark and save
    pdfDocument.ApplyWatermark("CONFIDENTIAL", 30, VerticalAlignment.Middle, HorizontalAlignment.Center);
    pdfDocument.SaveAs("Processed_Invoice.pdf");

    Console.WriteLine("Invoice downloaded and secured via IronPDF.");
}
using CurlDotNet;
using IronPdf;

// 1. Use CurlDotNet to handle the complex transport
// We use -k to allow insecure SSL (common in legacy internal apps)
var curlCommand = "curl -k https://internal-billing.local/invoice/1234 -H 'X-Dept: Sales'";
var response = await Curl.ExecuteAsync(curlCommand);

if (response.IsSuccess)
{
    // 2. Pass the raw bytes directly to IronPDF
    // IronPDF renders the PDF from the downloaded data
    var pdfDocument = PdfDocument.FromPdf(response.BodyBytes);

    // 3. Apply a watermark and save
    pdfDocument.ApplyWatermark("CONFIDENTIAL", 30, VerticalAlignment.Middle, HorizontalAlignment.Center);
    pdfDocument.SaveAs("Processed_Invoice.pdf");

    Console.WriteLine("Invoice downloaded and secured via IronPDF.");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

控制台确认

！写入控制台确认 PDF 已保存的确认。

PDF 输出

！输出 PDF 文件示例。

示例 2：使用 IronOCR 进行抓取和 OCR.

IronOCR

IronOCR 是由 Tesseract 5 引擎提供支持的高级光学字符识别库，专门针对 C# 和 .NET 进行了微调。 它支持超过127种语言，并擅长从不完美的来源中读取文本，例如低分辨率扫描、旋转图像或嘈杂的背景。 它的 "计算机视觉 "功能使其能够自动检测文本区域，不仅可以将数据输出为纯字符串，还可以输出为结构化内容（Barcode、段落、行和字符），以便进行深度分析。

有时，您需要从托管在阻止标准 .NET scrapers 的服务器上的图像中提取数据。 您可以使用 CurlDotNet 毫不费力地模仿标准浏览器用户代理，然后使用 IronOCR 阅读文本。

using CurlDotNet;
using IronOcr;

// 1. Fetch the image using a specific browser User-Agent to bypass blocks
var imgResponse = await Curl.GetAsync("https://site.com/protected-captcha.png")
    .WithUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64)")
    .ExecuteAsync();

// 2. Use IronOCR to read text from the file bytes
var ocr = new IronTesseract();
using (var input = new OcrInput())
{
    input.AddImage(imgResponse.BodyBytes);
    var result = ocr.Read(input);

    // 3. Output the extracted string value
    Console.WriteLine($"OCR Result: {result.Text}");
}
using CurlDotNet;
using IronOcr;

// 1. Fetch the image using a specific browser User-Agent to bypass blocks
var imgResponse = await Curl.GetAsync("https://site.com/protected-captcha.png")
    .WithUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64)")
    .ExecuteAsync();

// 2. Use IronOCR to read text from the file bytes
var ocr = new IronTesseract();
using (var input = new OcrInput())
{
    input.AddImage(imgResponse.BodyBytes);
    var result = ocr.Read(input);

    // 3. Output the extracted string value
    Console.WriteLine($"OCR Result: {result.Text}");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

OCR 输出示例

！将 IronOCR 与 CurlDotNet 结合使用的输出示例。

示例 3：使用 IronBarcode 管理库存

IronBarcode

IronBarcode是一个多功能库，设计用于读取和写入几乎任何条形码格式，从标准的 UPC 和 EAN 到复杂的 QR 码和数据矩阵标记。 它是为容错而构建的； 该库包括自动图像校正过滤器，可以锐化、潜在二值化和旋转图像，以检测条形码，即使条形码受损、倾斜或光线不足。 因此，在没有硬件扫描仪的物流、零售和工业应用领域，它是必不可少的工具。

在这种情况下，我们使用 CurlDotNet 的精确网络控制从安全 API 获取标签，并使用 IronBarcode 强大的 读取引擎即时验证内容。

using CurlDotNet;
using IronBarCode;

class Program
{
    private static readonly HttpClient client = new HttpClient();
    public static async Task Main(string[] args)
    {

        // 1. Define the URL 
        string url = "https://barcodeapi.org/api/128/Shipping-Label-Test-123";

        try
        {
            // Add the session cookie to the request headers
            client.DefaultRequestHeaders.Add("Cookie", "session_id=xyz123");

            // 2. Download the image data as a Byte Array (Preserves binary integrity)
            byte[] imageBytes = await client.GetByteArrayAsync(url);

            Console.WriteLine($"Downloaded {imageBytes.Length} bytes.");

            // 3. Read the barcode directly from the byte array
            var result = BarcodeReader.Read(imageBytes);

            foreach (var barcode in result)
            {
                Console.WriteLine($"Detected Format: {barcode.BarcodeType}");
                Console.WriteLine($"Value: {barcode.Value}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
using CurlDotNet;
using IronBarCode;

class Program
{
    private static readonly HttpClient client = new HttpClient();
    public static async Task Main(string[] args)
    {

        // 1. Define the URL 
        string url = "https://barcodeapi.org/api/128/Shipping-Label-Test-123";

        try
        {
            // Add the session cookie to the request headers
            client.DefaultRequestHeaders.Add("Cookie", "session_id=xyz123");

            // 2. Download the image data as a Byte Array (Preserves binary integrity)
            byte[] imageBytes = await client.GetByteArrayAsync(url);

            Console.WriteLine($"Downloaded {imageBytes.Length} bytes.");

            // 3. Read the barcode directly from the byte array
            var result = BarcodeReader.Read(imageBytes);

            foreach (var barcode in result)
            {
                Console.WriteLine($"Detected Format: {barcode.BarcodeType}");
                Console.WriteLine($"Value: {barcode.Value}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronBarcode 控制台输出

！将 IronBarcode 与 CurlDotNet 结合使用的输出示例。

将 "Userland "引入 .NET.

CurlDotNet 将 "Userland "概念引入 .NET 不仅仅是提出请求。 它允许您在CI管道或运行Linux macOS或windows的docker容器等地方使用标准的curl功能。

您可以在 DotNet 运行上下文中使用标准 bash 语法下载文件、上传数据或触发 webhook。 这将在命令行工具世界与您的编译应用程序之间架起一座桥梁。

结论：翻译税的终结

这不仅仅是提出 HTTP 请求； 尊重开发人员的时间。Jacob Mellor 和 Iron Software 明白，如果像 curl 这样的工具已经完美运行了 25 年，.NET 运行时就应该接纳它，而不是强迫你重新实现它。

采用 CurlDotNet 不仅仅是增加一个依赖关系； 您正在采用的工作流程是优先发布功能，而不是编写模板。 停止 "翻译"，开始执行。 无论您是抓取单个 JSON 文件，还是协调复杂的 Iron Software 文档工作流，指令都是一样的：粘贴、运行、完成。

下一步

不再浪费时间翻译头文件和调试 HttpClient。 加入 Userland.NET 运动。

1.查看 GitHub：访问 jacob-mellor/curl-dot-net 查看源代码、文档和示例目录。

2.下载 NuGet 包：运行 DotNet 添加包 CurlDotNet 安装库。

3.探索 Iron Software：了解 IronPDF 和 IronOCR 如何与 CurlDotNet 协同工作，加速您的项目。

通过利用 CurlDotNet，您可以确保您的 curl 命令和 C# 代码使用完全相同的语言。