CLIの簡素化と.NETの橋渡し:Curl DotNetとIronPDFを使う
迅速なコマンドラインツールスクリプトと堅牢な.NETコードの間のギャップをナビゲートする開発者にとって、摩擦はしばしば、C#内で適切なHTTPリクエストに動作するcURLコマンドを翻訳することにあります。 Jacob Mellorは、CurlDotNetでこのギャップを埋めました。これは、.NETエコシステムにcURLの親しみやすさをもたらすために作成されたライブラリです。
IronPDFやIronXLのようなIron Software製品とこのツールを組み合わせることで、複雑なAPIコールを介してデータを取得し、すぐにプロフェッショナルなレポートを生成する強力なパイプラインを構築することができます。 この記事では、プロジェクトを次のレベルに引き上げるために、これらのツールが連携できるいくつかの例を見ていきます。
CurlDotNetとは
CurlDotNetは、業界標準のcurlツールの純粋なC# .NET実装です。 ネイティブの依存関係やlibcurlに依存するラッパーとは異なり、このライブラリは、Windows、Linux、macOSなどを完全にサポートする100%マネージドソリューションを提供します。 標準クライアントと同じ動作を保証し、APIドキュメントからコマンドのbashコピーをコードに直接貼り付けることができます。
クイック スタートとインストール
開始するには、プロジェクトディレクトリで次のコマンドを実行するだけです:
dotnet add パッケージ curldotnet
CurlDotNetパッケージがインストールされ、HttpClient設定のオーバーヘッドなしにWebリクエストを処理するためのレシピにアクセスできるようになります。
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)
.NET コード Curl DotNet 出力

構造化されたアプローチを好む人のために、fluentビルダーは、ヘッダー、curlオプション、およびアクセストークンを設定するためのクリーンなAPIを提供します。
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()
この柔軟性は、TLSハンドシェイクの仕組み、レート制限、エラー処理を内部的に処理し、curl実行ファイルのデフォルトの動作を模倣します。
.NET FrameworkでのIron Softwareとの統合
CurlDotNetの出力をIron Softwareツールにパイプすることで、真の力が発揮されます。 CurlDotNet はトランスポート層 (JSON、ファイル、または HTML の取得) を処理するため、 Iron Software製品はそのコンテンツの処理に集中できます。
シナリオAPIデータからPDFレポートを生成する
安全なURLからユーザーデータをダウンロードし、PDFレポートを作成する必要があるとします。 APIには特定の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
ステップ2: IronPDFでPDFを生成する
IronPDFは、HTML、CSS、JavaScript、画像を忠実度の高いPDFドキュメントにレンダリングするために設計された強力なライブラリです。 最新のWeb標準を完全にサポートし、ヘッダー、フッターの追加、特定のレンダリングオプションの設定などの機能を含みます。
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")
出力

シナリオJSONをExcelにエクスポートする
アプリがJSONフィードを消費する場合、CurlDotNetのテスト機能を使用してフェッチし、IronXLを使用してエクスポートすることができます。
ステップ 1: Curl-Dot-Net で JSON データをフェッチする
JSONフィードのフェッチには、クリーンな.NETコードのためのfluentビルダーを使用しています:
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
ステップ2: IronXLを使用してExcelにロードしてエクスポートする
IronXLは、読み込み、書き込み、およびExcelファイル形式(.xlsx、.xls、.csv)の操作のすべての側面を処理するように設計された包括的な.NETライブラリです。 重要なのは、サーバーやクライアントマシンに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))
出力Excelファイル

なぜこの組み合わせなのか?
1.クロスプラットフォームの一貫性: CurlDotNetとIronSoftware の両製品は、Windows、Linux、macOS をサポートしています。 これは、Microsoft AzureやAWS Lambdaのようなランタイム環境で実行されるCI CDパイプラインにとって非常に重要です。
2.コード生成:開発者は、多くの場合、bash またはシェル形式でコード生成スニペットを取得します。 curl-dot-net を使用すると、これらのスニペットを直接使用できますが、 Iron Software がドキュメント操作の面倒な作業を処理します。
3.ネイティブ依存関係なし: CurlDotNet は純粋な C# 実装であるため、異なる OS バージョン上の外部 C++ ライブラリまたは libcurl バイナリのリンクに関連する一般的な問題を回避できます。
結論
Jacob Mellorは、DotNetコミュニティに不可欠なツールを提供しました。 開発者が.NET FrameworkおよびCoreアプリケーション内で使い慣れたcurlオプションを使用できるようにすることで、CurlDotNetはhttpリクエストプロセスを簡素化します。 Iron Softwareと組み合わせることで、シームレスなワークフローを作ることができます: curlの正確さでデータを取得し、IronPDFやIronXLのパワーで処理します。
問題が発生した場合は、GitHub ページにバグを報告して、すべてのユーザーのサポート向上に役立ててください。
よくある質問
CurlDotNetとは?
CurlDotNetは、cURLの機能を.NETエコシステムにもたらすためにJacob Mellorによって作成されたライブラリで、開発者はcURLコマンドを.NETコードに簡単に翻訳することができます。
CurlDotNetは開発者にどのように役立ちますか?
CurlDotNetは、C#内でcURLコマンドライン操作をHTTPリクエストに変換するプロセスを簡素化することで開発者を支援し、コマンドラインツールのスクリプトを堅牢な.NETアプリケーションに簡単に統合できるようにします。
CurlDotNetはどのような問題を解決しますか?
CurlDotNetは、C#で動作するcURLコマンドを適切なHTTPリクエストに変換する際に開発者が直面する摩擦の問題を解決します。CurlDotNetは、cURLのシンプルさに慣れ親しんだ開発者に、使い慣れたアプローチを提供します。
CurlDotNetはIronPDFと一緒に使用できますか?
はい、CurlDotNetは.NETアプリケーションのPDF生成ワークフローの一部としてHTTPリクエストのしやすさを向上させるためにIronPDFと一緒に使用することができます。
CurlDotNetは初心者に適していますか?
CurlDotNetは、.NETやHTTPリクエストに慣れていない方でも学習しやすい、使い慣れたコマンドラインスタイルのインターフェイスを提供しているため、初心者の方にも適しています。
CurlDotNetをIronPDFで使用する利点は何ですか?
CurlDotNetとIronPDFを使用することで、開発者はPDFを生成しながらHTTPリクエストを合理化し、効率を向上させ、両方のツールの長所を活用することができます。
CurlDotNetについてもっと知りたいのですが?
CurlDotNetの詳細については、Mediumに掲載されたJacob Mellorの記事をご覧ください。この記事では、ライブラリがcURLコマンドと.NETコード間のギャップをどのように埋めるかについての詳細な洞察を提供しています。




