Curl DotNet: Dodanie supermocy Curl do środowiska .NET

Najważniejsze cechy

• Zero Translation: Wklej polecenie curl HTTPS bezpośrednio do kodu źródłowego C#.

• Wielopłatformowość: Pełna obsługa systemów Windows, Linux, MacOS i innych.

• Bezpieczeństwo typów: Możliwość użycia płynnego Buildersa w scenariuszach wstrzykiwania zależności.

• Obserwowalność: Wbudowana obsługa generowania zdarzeń strukturalnych do rejestrowania.

Interfejs API String: Polecenia Curl typu "wklej i uruchom"

Ta metoda jest idealna do kontroli stanu, obsługi technicznej lub szybkiego prototypowania. Wystarczy przekazać polecenie curl jako ciąg znaków.

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);

Imports CurlDotNet

' Simply paste the command string
Dim response = Await Curl.ExecuteAsync("curl https://api.github.com/users/octocat")

' Access the data
Console.WriteLine(response.Body)

Korzystanie z Fluent Builder przy użyciu zmiennych środowiskowych

W przypadku aplikacji produkcyjnych, w których konieczne jest przetwarzanie wrażliwych danych za pomocą zmiennych środowiskowych lub wymagańa jest bardziej przejrzysta architektura, idealnym rozwiązaniem jest Fluent Builder. Można podać nazwę ciągu znaków dla nagłówków lub jawnie ustawić ścieżkę do pliku.

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();

Dim response = Await Curl.GetAsync("https://api.example.com/data") _
    .WithHeader("Authorization", "Bearer " & Environment.GetEnvironmentVariable("API_KEY")) _
    .WithTimeout(TimeSpan.FromSeconds(30)) _
    .ExecuteAsync()

Przykład 1: Bezpieczne pobieranie i edycja plików PDF za pomocą IronPDF

IronPDF to branżowy standard tworzenia plików PDF o idealnej jakości pikseli w środowisku .NET. W przeciwieństwie do innych bibliotek, które mają trudności z obsługą nowoczesnych standardów internetowych, IronPDF renderuje HTML, CSS i JavaScript dokładnie tak, jak robi to przeglądarka Chrome. Jest to kompletne rozwiązanie: można generować nowe dokumenty na podstawie ciągów znaków HTML lub plików, edytować istniejące pliki PDF, łączyć dokumenty oraz stosować zabezpieczenia, takie jak znaki wodne i szyfrowanie, bez konieczności korzystania z zewnętrznych zależności lub instalowania programu Adobe Acrobat na serwerze.

Wyobraź sobie, że musisz pobrać wygenerowaną fakturę ze starszego systemu wewnętrznego, który wymaga złożonych flag curl (takich jak ignorowanie błędów SSL lub konkretnych permutacji nagłówków), a następnie opatrzyć ją znakiem wodnym za pomocą IronPDF.

Przekształcenie tego żądania na HttpClient może zająć wiele godzin debugowania. Dzięki CurlDotNet wystarczy wkleić polecenie, pobrać bajty i przekazać je do 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.");
}

Imports CurlDotNet
Imports IronPdf

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

If response.IsSuccess Then
    ' 2. Pass the raw bytes directly to IronPDF
    ' IronPDF renders the PDF from the downloaded data
    Dim 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.")
End If

Potwierdzenie w konsoli

Wynik w formacie PDF

Przykład 2: Scraping i OCR z IronOCR

IronOCR to zaawansowana biblioteka do optycznego rozpoznawania znaków oparta na silniku Tesseract 5, dostosowana specjalnie do języka C# i platformy .NET. Obsługuje ponad 127 języków i doskonale radzi sobie z odczytywaniem tekstu z niedoskonałych źródeł — takich jak skany o niskiej rozdzielczości, obrócone obrazy lub tła z zakłóceniami. Jego funkcje "Computer Vision" pozwalają na automatyczne wykrywanie obszarów tekstu, a dane mogą być wyświetlane nie tylko jako zwykłe ciągi znaków, ale jako treść ustrukturyzowana (BarCode, akapity, wiersze i znaki) do dogłębnej analizy.

Czasami trzeba wyodrębnić dane z obrazu umieszczonego na serwerze, który blokuje standardowe narzędzia do scrapingu .NET Standard. Możesz użyć CurlDotNet, aby bez wysiłku naśladować standardowego agenta użytkownika przeglądarki, a następnie użyć IronOCR do odczytania tekstu.

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}");
}

Imports CurlDotNet
Imports IronOcr

' 1. Fetch the image using a specific browser User-Agent to bypass blocks
Dim 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
Dim ocr = New IronTesseract()
Using input = New OcrInput()
    input.AddImage(imgResponse.BodyBytes)
    Dim result = ocr.Read(input)

    ' 3. Output the extracted string value
    Console.WriteLine($"OCR Result: {result.Text}")
End Using

Przykładowy wynik OCR

Przykład 3: Zarządzanie zapasami za pomocą 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}");
        }
    }
}

Imports CurlDotNet
Imports IronBarCode
Imports System.Net.Http

Module Program
    Private ReadOnly client As New HttpClient()

    Public Async Function Main(args As String()) As Task

        ' 1. Define the URL 
        Dim url As String = "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)
            Dim imageBytes As Byte() = Await client.GetByteArrayAsync(url)

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

            ' 3. Read the barcode directly from the byte array
            Dim result = BarcodeReader.Read(imageBytes)

            For Each barcode In result
                Console.WriteLine($"Detected Format: {barcode.BarcodeType}")
                Console.WriteLine($"Value: {barcode.Value}")
            Next
        Catch ex As Exception
            Console.WriteLine($"Error: {ex.Message}")
        End Try
    End Function
End Module