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

Imports Flurl
Imports Flurl.Http

' Configure a FlurlClient instance with base URL and headers
Private flurlClient As 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}");
}

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

If response.ResponseMessage.IsSuccessStatusCode Then
	Dim result = Await response.ResponseMessage.Content.ReadAsStringAsync()
	Console.WriteLine(result)
Else
	Console.WriteLine($"Error: {response.StatusCode}")
End If

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

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

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

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

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

Imports Flurl
Imports Flurl.Http
Imports IronPdf
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Try
			Dim response = await "http://localhost:5013/users/1".GetJsonAsync(Of User)()
			Dim id = response?.Id
			Dim name = response?.Name
			Console.WriteLine($"Data fetched successfully: {name}")

			' Generate PDF using IronPDF
			Dim renderer = New ChromePdfRenderer()
			Dim htmlTemplate As String = $"
                <html>
                <body>
                    <h1>{id}</h1>
                    <p>{name}</p>
                </body>
                </html>"

			' Generate PDF document from HTML template
			Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate)

			' Save or stream the PDF document
			pdfDocument.SaveAs("document.pdf")
			Console.WriteLine("PDF document generated successfully.")
		Catch ex As FlurlHttpException
			Console.WriteLine($"HTTP Error: {ex.Message}")
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		End Try
	End Function
End Class

' Example model class for JSON deserialization
Public Class User
	Public Property Id() As Integer
	Public Property Name() As String
End Class

この例では、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が要求する適切な認証方法を使用してください。