Flurl C#（開発者向けの仕組み）

流暢なインターフェース

Flurlが提供する流暢でチェーン可能な構文は、プログラムの可読性と保守性を向上させます。 開発者はシンプルで表現力豊かなHTTPリクエストを作成し、URL、クエリパラメータ、ヘッダー、およびペイロードを操作することができます。

HTTPメソッドのサポート

GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONSを含むすべての標準HTTPメソッドがサポートされています。 この包括的なサポートアプローチのおかげで、開発者はWeb API作業時にさまざまなタスクを実行できます。

クエリパラメータの処理

FlurlはURL内のクエリパラメーターの変更、追加、削除の簡単な方法を提供します。 ユーザー入力や実行時の状況に基づいて動的なURLを作成するのが簡単になります。

JSONサポート

FlurlはJSONデータ処理をネイティブでサポートしています。 JSON応答をC#オブジェクトに簡単にデシリアライズし、オブジェクトをリクエストペイロード用にJSONにシリアル化できます。 これにより、JSONベースのAPIの利用がシンプルで簡単になります。

フォームデータおよびマルチパートサポート

マルチパートリクエストとフォームデータの管理を容易にします。 Flurlは、開発者がHTTPリクエストにマルチパート/フォームデータペイロードやフォームエンコードデータを簡単に含めることを可能にします。

エラーハンドリングとリトライポリシー

Flurlは、すべてのHTTPコールに対してリトライポリシーの定義とエラーハンドリング機能を提供します。 開発者は、特定のエラーハンドリングロジックやリトライ手法を定義することで、APIコールとやり取りの回復力と信頼性を高めることができます。 これにより、応答における匿名オブジェクトエラーが防止され、保護されます。

認証

OAuth、カスタム認証スキーム、基本認証、APIキーなどの人気のあるWeb API認証方法をサポートしています。 これにより、認証が必要なAPIとの安全な通信が確保されます。

テストサポート

HTTP関連のロジックを再利用可能なコンポーネントに分離し、明確な関心の分離を提供することで、Flurlはテスト可能性を促進します。 これにより、実際のネットワークコールなしでAPIのやり取りをテストするための単体テストの作成が容易になります。

構成の柔軟性

HTTPクライアントとリクエストパラメーターの構成の柔軟性を提供します。 開発者は、特定のアプリケーションやAPI制限のニーズに合わせて、クライアントの動作、タイムアウト、エラーレスポンスの量、ヘッダー、その他の設定を変更できます。

拡張性

プラグインのフレームワークにより、Flurlは非常に拡張性があります。 開発者は独自の拡張機能を構築したり、プラットフォームの機能を増強するためのサードパーティのプラグインを統合したりできます。

新しいVisual Studioプロジェクトの作成

Install-Package Flurl.Http

using Flurl;
using Flurl.Http;

// Configure a FlurlClient instance with base URL and headers
FlurlClient flurlClient = new FlurlClient("https://api.example.com/");
flurlClient.WithHeader("Authorization", "Bearer YourAccessTokenHere");

using Flurl;
using Flurl.Http;

// Configure a FlurlClient instance with base URL and headers
FlurlClient flurlClient = new FlurlClient("https://api.example.com/");
flurlClient.WithHeader("Authorization", "Bearer YourAccessTokenHere");

var response = await "http://localhost:5013/users".GetAsync();
Console.WriteLine(response.ToString());

if (response.ResponseMessage.IsSuccessStatusCode)
{
    var result = await response.ResponseMessage.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

var response = await "http://localhost:5013/users".GetAsync();
Console.WriteLine(response.ToString());

if (response.ResponseMessage.IsSuccessStatusCode)
{
    var result = await response.ResponseMessage.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

// Handling JSON response
var responseObject = await "https://api.example.com/resource"
    .WithClient(flurlClient)
    .GetJsonAsync<ResponseType>();
// Assuming ResponseType is a class representing the expected JSON structure
Console.WriteLine($"Response: {responseObject.Property}");

// Handling JSON response
var responseObject = await "https://api.example.com/resource"
    .WithClient(flurlClient)
    .GetJsonAsync<ResponseType>();
// Assuming ResponseType is a class representing the expected JSON structure
Console.WriteLine($"Response: {responseObject.Property}");

IronPDFとは？

IronPDFというC#プログラムでPDFドキュメントを作成、読み取り、修正できる機能豊富な.NETライブラリが存在します。 このツールにより、開発者はHTML、CSS、JavaScriptコンテンツから印刷可能で高品質なPDFを迅速に生成できます。 いくつかの基本的な機能には、透かしの追加、ヘッダーとフッターの作成、PDFの分割と結合、HTMLのPDFへの変換機能が含まれます。 IronPDFは.NET Frameworkと.NET Coreをサポートしており、さまざまなアプリケーションに便利です。

PDFは簡単に統合され、詳細なドキュメントが豊富にあるため、開発者はそれらを簡単にアプリケーションに利用できます。 IronPDFは、複雑なレイアウトとスタイリングを効率的に処理することで、生成されたPDFがソースHTMLコンテンツに非常に類似することを保証します。

IronPDFはウェブページ、URL、HTMLを元のコンテンツそっくりに見える高品質なPDFに変換するのを非常に簡単にします。 これはオンラインレポートや請求書のPDFを作成するのに最適です。 HTMLをPDFに変換する方法を探しているなら、IronPDFがカバーします！

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

IronPDF の機能

HTMLからのPDF生成

JavaScript、HTML、CSSをPDFに変換します。 メディアクエリやレスポンシブデザインなど、現代のウェブ標準に対応しています。 HTMLやCSSでPDFレポート、請求書、ドキュメントをダイナミックにデコレーションするのに役立ちます。

PDF編集

既存のPDFにテキスト、写真、その他のコンテンツを追加できます。 PDFファイルからテキストや画像を削除できます。 複数のPDFを1つのファイルに統合できます。PDFファイルを複数の別々の文書に分割することができます。 透かし、注釈、ヘッダー、フッターを含めることができます。

PDF変換

Word、Excel、および画像ファイルを含むさまざまなファイルタイプをPDF形式に変換します。 PDFから画像（PNG、JPEG、など）への変換。

性能と信頼性

高性能と信頼性は、広範なドキュメントコレクションを効果的に管理するために、産業環境で求められる設計特性です。

IronPDFをインストールする

.NETプロジェクトでPDFを操作するためのツールを手に入れるために、IronPDFパッケージをインストールしてください。

Install-Package IronPdf

データをフルールでフェッチしてPDFを生成する

Flurlの流暢なAPIを利用してHTTPクエリを行い、APIからデータを取得します。 これはJSONデータを取得するインスタンスです:

using Flurl;
using Flurl.Http;
using IronPdf;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            var response = await "http://localhost:5013/users/1".GetJsonAsync<User>();
            var id = response?.Id;
            var name = response?.Name;
            Console.WriteLine($"Data fetched successfully: {name}");

            // Generate PDF using IronPDF
            var renderer = new ChromePdfRenderer();
            string htmlTemplate = $@"
                <html>
                <body>
                    <h1>{id}</h1>
                    <p>{name}</p>
                </body>
                </html>";

            // Generate PDF document from HTML template
            var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);

            // Save or stream the PDF document
            pdfDocument.SaveAs(@"document.pdf");
            Console.WriteLine("PDF document generated successfully.");
        }
        catch (FlurlHttpException ex)
        {
            Console.WriteLine($"HTTP Error: {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

// Example model class for JSON deserialization
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}

using Flurl;
using Flurl.Http;
using IronPdf;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            var response = await "http://localhost:5013/users/1".GetJsonAsync<User>();
            var id = response?.Id;
            var name = response?.Name;
            Console.WriteLine($"Data fetched successfully: {name}");

            // Generate PDF using IronPDF
            var renderer = new ChromePdfRenderer();
            string htmlTemplate = $@"
                <html>
                <body>
                    <h1>{id}</h1>
                    <p>{name}</p>
                </body>
                </html>";

            // Generate PDF document from HTML template
            var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);

            // Save or stream the PDF document
            pdfDocument.SaveAs(@"document.pdf");
            Console.WriteLine("PDF document generated successfully.");
        }
        catch (FlurlHttpException ex)
        {
            Console.WriteLine($"HTTP Error: {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

// Example model class for JSON deserialization
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}

この例では、Flurlの.GetJsonAsync()関数を使用してGETリクエストを送信し、JSONデータを取得します。 UserをAPI応答構造を表すモデルクラスに置き換え、"URL"には実際のAPIエンドポイントを使用してください。 IronPDFのChromePdfRendererクラスを使用すると、HTMLテンプレート（htmlTemplate）をPDFドキュメントとしてレンダリングできます。 ここでは、APIから取得したタイトルと本文のデータを使用してHTMLテンプレートを動的に構築します。 作成されたPDFドキュメント（pdfDocument）は、ファイルシステム上の指定された場所（"document.pdf"）に保存されます。 パスを必要に応じて変更してください。

データ取得やPDF生成中のネットワーク障害（FlurlHttpException）や一般的な例外（Exception）などの問題に対して、堅牢なエラーハンドリングを提供します。 IronPDFを使用して、ページサイズ、余白、ヘッダー、フッター、その他のPDF設定を変更できます。 高度なカスタマイズの可能性については、IronPDFのマニュアルを参照してください。 APIにHTTPクエリを送信する際には、敏感なデータやアクセストークンを安全に扱うことを確認してください。 APIが要求する適切な認証方法を使用してください。