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 請求中包含 multipart/form-data 有效負載或表單編碼資料。

錯誤處理與重試原則

Flurl 為所有 HTTP 呼叫提供重試原則定義與錯誤處理功能。 透過定義獨特的錯誤處理邏輯或重試技術，開發人員可以增強 API 呼叫和互動的彈性和可靠性。 這也保障並協助開發人員避免回應中的匿名物件錯誤。

驗證

它支援多種常用的 Web API 認證方法，包括 OAuth、自訂認證方案、Basic Authentication 和 API keys。 這可確保與需要驗證的 API 進行安全的溝通。

測試支援

Flurl 將 HTTP 相關的邏輯隔離成可重複使用的元件，並明確分隔不同的關注點，藉此提高可測試性。 這讓 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?

在 C# 程式中，有一個功能豐富的 .NET 函式庫，名為 IronPDF for .NET，可以用來建立、讀取和修改 PDF 文件。 在此工具的協助下，開發人員能夠從 HTML、CSS 和 JavaScript 內容快速產生可供列印的高品質 PDF。 一些基本功能包括：水印、製作頁首和頁尾、分割和合併 PDF，以及將 HTML 轉換為 PDF。 IronPDF 支援 .NET Framework 和 .NET Core，因此適用於各種應用程式。

由於 PDF 簡單易於整合，且擁有豐富詳盡的說明文件，因此開發人員可以輕鬆地在其應用程式中採用 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 合併為一個檔案。PDF 檔案可分為多個獨立的文件。 可以包含水印、註解、頁首和頁尾。

PDF 轉檔

將多種檔案類型（包括 Word、Excel 和圖片檔案）轉換為 PDF 格式。 PDF 到圖像的轉換（PNG、JPEG 等）。

效能與可靠性

在工業環境中，高效能和可靠度是所需的設計特質，因為它們可以有效管理大量的文件收藏。

安裝 IronPDF

要獲得在 .NET 專案中使用 PDF 所需的工具，請安裝 IronPDF 套件。

Install-Package IronPdf

使用 Flurl 擷取資料以產生 PDF

若要進行 HTTP 查詢並從 API 取得資料，請使用 Flurl 的流暢 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 模板 (htmlTemplate) 可以使用 IronPDF 的 ChromePdfRenderer 類渲染成 PDF 文件。 在此，從 API 擷取的標題和正文資料會被用來動態建構 HTML 模板。 建立的 PDF 文件 (pdfDocument) 會儲存到檔案系統上的指定位置 ("document.pdf")。 根據需要修改路徑。

在資料取得或 PDF 製作過程中，針對網路故障 (FlurlHttpException) 或一般異常 (Exception) 等問題提供強大的錯誤處理功能。 您可以使用 IronPDF 更改頁面大小、邊界、頁首、頁尾以及其他 PDF 設定。 如需瞭解更多進階的客製化可能性，請參閱 IronPdf 的方式手冊。 向 API 傳送 HTTP 查詢時，請確保敏感資料和存取代碼得到安全處理。 使用您的 API 所需的正確認證方法。