Curl DotNet : Les superpuissances de Curl au service de l'exécution .NET

Fonctionnalités clés

• Traduction zéro: Collez les commandes HTTPS curl directement dans votre source C#.

• Cross-Platform: Prise en charge complète de Windows, Linux, MacOS, etc.

• Type Safety: Option d'utilisation d'un constructeur fluide pour les scénarios d'injection de dépendances.

• Observabilité: Prise en charge intégrée de l'émission d'événements structurés pour la journalisation.

L'API des chaînes de caractères : Les commandes Curl Paste et Go

Cette méthode est parfaite pour les bilans de santé, les agents d'assistance ou le prototypage rapide. Il suffit de transmettre la commande curl sous la forme d'une chaîne de caractères.

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

Utilisation de Fluent Builder avec des variables d'environnement

Pour les applications de production où vous devez manipuler des données sensibles via des variables d'environnement, ou qui nécessitent une architecture plus propre, le fluent builder est idéal. Vous pouvez spécifier un nom de chaîne pour les en-têtes ou définir explicitement un chemin d'accès au fichier.

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

Exemple 1 : Téléchargement et édition sécurisés de fichiers PDF avec IronPDF

IronPDF est la norme industrielle pour générer des PDF parfaits au pixel près dans .NET. Contrairement à d'autres bibliothèques qui se débattent avec les normes web modernes, IronPDF rend HTML, CSS, et JavaScript exactement comme le ferait un navigateur Chrome. Il est conçu pour être une solution complète : vous pouvez générer de nouveaux documents à partir de chaînes HTML ou fichiers, éditer des PDF existants, fusionner des documents et appliquer des fonctions de sécurité telles que le filigrane et le cryptage sans avoir besoin de dépendances externes ou qu'Adobe Acrobat soit installé sur le serveur.

Imaginez que vous deviez télécharger une facture générée à partir d'un ancien système interne qui nécessite des drapeaux curl complexes (comme ignorer les erreurs SSL ou des permutations d'en-tête spécifiques), puis watermark l'utiliser à l'aide d'IronPDF.

La traduction de cette requête en HttpClient pourrait nécessiter des heures de débogage. Avec CurlDotNet, vous collez la commande, obtenez les octets et les remettez à 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

Confirmation de console

Confirmation écrite dans la console confirmant que le PDF est enregistré

PDF en sortie

Exemple de fichier PDF de sortie

Exemple 2 : Scraping et OCR avec IronOCR

IronOCR est une bibliothèque de reconnaissance optique de caractères avancée alimentée par le moteur Tesseract 5, peaufinée spécifiquement pour C# et .NET. Le logiciel prend en charge plus de 127 langues et excelle dans la lecture de textes provenant de sources imparfaites : scans à faible résolution, images pivotées ou arrière-plans bruyants. Ses capacités de "Computer Vision" lui permettent de détecter automatiquement les régions de texte, et il peut restituer les données non seulement sous forme de chaînes de caractères simples, mais aussi sous forme de contenu structuré (codes-barres, paragraphes, lignes et caractères) en vue d'une analyse approfondie.

Vous devez parfois extraire des données d'une image hébergée sur un serveur qui bloque les scrapers .NET standard. Vous pouvez utiliser CurlDotNet pour imiter sans effort un agent utilisateur de navigateur standard, puis utiliser IronOcr pour lire le texte.

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

Exemple de sortie de l'OCR

Exemple de sortie pour l'utilisation d'IronOCR avec CurlDotNet

Exemple 3 : Gestion des stocks avec 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