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

Fluent Interface

Flurl提供的流暢的、可連結的語法增強了程式的可讀性和可維護性。 開發者可以建立簡單而富有表達力的HTTP請求，並處理URLs、查詢參數、標頭和有效負載。

HTTP Method Support

支持所有標準的HTTP方法，包括GET、POST、PUT、DELETE、PATCH、HEAD和OPTIONS。 由於這種全面的支持方法，使得開發者在工作於網路API時可以完成各種任務。

Query Parameter Handling

Flurl提供了輕鬆的方法來修改、新增和刪除URL中的查詢參數。 這使得根據使用者輸入或運行時情況建立動態URL變得更加容易。

JSON Support

Flurl原生支持JSON資料處理。 它可以輕鬆地將JSON響應反序列化為C#物件，並將物件序列化為JSON以供請求有效負載使用。 由於這一點，使用基於JSON的API變得簡單而容易。

Form Data and Multipart Support

它使得管理multipart請求和表單資料變得更加容易。 Flurl使開發者可以輕鬆地在HTTP請求中包含multipart/form-data有效負載或表單編碼資料。

Error Handling and Retry Policies

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

Authentication

它支持多種流行的Web API身份驗證方法，包括OAuth、自定義身份驗證方案、Basic Authentication和API金鑰。 這確保了與需要身份驗證的API之間的安全通訊。

Testing Support

通過將HTTP相關邏輯隔離到可重用的組件中，配合明確的關注點分離，Flurl鼓勵了可測試性。 這使得編寫API交互的單元測試變得簡單，無需進行實際的網路呼叫來測試它們。

Configuration Flexibility

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

Imports System
Imports Flurl.Http

' Handling JSON response
Dim responseObject As ResponseType = Await "https://api.example.com/resource" _
    .WithClient(flurlClient) _
    .GetJsonAsync(Of 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使轉換網頁、URLs和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

⟨IMG⟩Flurl C#（如何為開發者工作）：圖5 - IronPDF：C# PDF程式庫⟨/IMG⟩

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

使用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響應結構，並用您的實際API端點替換"URL"。 HTML模版（ChromePdfRenderer類轉換成PDF檔案。 在此處，從API檢索的標題和正文資料用於動態構建HTML模板。 所建立的PDF文件（pdfDocument）保存到文件系統中指定的位置（"document.pdf"）。 根據需要修改路徑。

⟨IMG⟩Flurl C#（如何為開發者工作）：圖6 - 範例控制臺輸出⟨/IMG⟩

為資料提取或PDF生成期間的網路故障（Exception）提供強大的錯誤處理。 您可以使用IronPDF更改頁面大小、邊距、頁眉、頁腳和其他PDF設置。 有關更高級的自定義可能性，請參考IronPDF的唯美手冊。 在向API發送HTTP查詢時，請確保機密資料和存取令牌得到安全處理。 使用您的API所需的正確身份驗證方法。