Flurl C# (對開發者如何運作)

流暢接口

Flurl提供的流暢、可鏈式語法增強了程式的可讀性和可維護性。 開發者可以創建簡單而具表達力的HTTP請求，並與URL、查詢參數、標頭和有效內容交互。

HTTP方法支持

支持所有標準的HTTP方法，包括GET、POST、PUT、DELETE、PATCH、HEAD和OPTIONS。 這種包羅萬象的支持方法使得開發者能夠在使用Web API時完成各種任務。

查詢參數處理

Flurl提供簡單的方法以修改、添加和刪除URL內的查詢參數。 它使得根據用戶輸入或運行時情況創建動態URL變得更容易。

JSON支持

Flurl原生支持JSON數據處理。 它能輕鬆將JSON回應反序列化為C#物件，並將物件序列化為JSON以作請求有效內容。 因此，使用基於JSON的API變得簡單而容易。

表單數據和多部分支持

它使管理多部分請求和表單數據變得更容易。 Flurl使開發者能輕鬆在HTTP請求中包含多部分/表單數據有效內容或表單編碼數據。

錯誤處理和重試策略

Flurl為所有HTTP調用提供重試策略定義和錯誤處理功能。 通過定義獨特的錯誤處理邏輯或重試方法，開發者可以增強API調用和交互的彈性和可靠性。 這也保護並幫助開發者防止回應中的匿名物件錯誤。

身份驗證

它支持多種流行的Web API身份驗證方法，包括OAuth、客製身份驗證方案、基本身份驗證和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？

一個功能豐富的.NET程式庫IronPDF可用於C#程式中創建、閱讀和修改PDF文檔。 藉助此工具，開發者可以快速從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");
    }
}

Flurl C# (How It Works For Developers): Figure 5 - IronPDF: The C# PDF Library

IronPDF的功能

由HTML生成PDF

將JavaScript、HTML和CSS轉換為PDF。 它支持媒體查詢和響應式設計，這是兩種當代Web標準。 它對於使用HTML和CSS動態裝飾PDF報告、發票和文件非常有用。

PDF編輯

可將文本、照片和其他內容添加到現有的PDF中。 可從PDF文件中移除文本和圖片。 許多PDF可合併成一個文件。PDF文件可以分成多個單獨的文檔。 可以包含水印、註釋、頁眉和頁腳。

PDF轉換

將Word、Excel和圖片文件等多種文件類型轉換為PDF格式。 PDF到圖像轉換（PNG、JPEG等）。

性能和可靠性

高性能和可靠性是工業環境中期望的設計特性，因為它們可以有效地管理大量的文檔集合。

安裝IronPDF

要獲得在.NET項目中處理PDF所需的工具，請安裝IronPDF套件。

Install-Package IronPdf

使用Flurl獲取數據以生成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端點。 HTML模板（ChromePdfRenderer類渲染為PDF文件。 此處，從API檢索的標題和主體數據被用來動態構建HTML模板。 創建的PDF文件（pdfDocument）被保存到文件系統的指定位置（"document.pdf"）。 根據需要更改路徑。

Flurl C# (How It Works For Developers): Figure 6 - Example Console output

為在數據獲取或PDF生成過程中遇到的問題（如網路故障Exception）提供強大的錯誤處理方法。 您可以使用IronPDF更改頁面大小、邊距、頁眉、頁腳和其他PDF設置。 如需更高級的自訂可能性，請參閱IronPDF的功能手冊。 當發送HTTP查詢到API時，請確保敏感數據和訪問令牌被安全處理。 使用您的API要求的正確身份驗證方法。