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

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的功能丰富的.NET库可用于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");
    }
}

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。 支持媒体查询和响应式设计，这两个是现代的网络标准。 在动态装饰PDF报告、发票和文件时使用HTML和CSS非常有用。

PDF编辑

可以添加文本、图片和其他内容到已有的PDF中。 可以从PDF文件中删除文本和图片。 能将多个PDF合并成一个文件。可以将PDF文件分成多个独立的文档。 可以加入水印、注释、页眉和页脚。

PDF转换

将多种文件类型，包括Word、Excel和图片文件，转换为PDF格式。 PDF到图像转换（PNG、JPEG等）。

性能和可靠性

在工业环境中，高性能和高可靠性是期望的设计品质，因为它们可以有效地管理多重文档。

安装IronPDF

为了在.NET项目中获得处理PDF所需的工具，请安装IronPDF包。

Install-Package IronPdf

使用Flurl获取数据生成PDF

为了使用Flurl的流畅API向您的API发起HTTP查询并获取数据。 这是一个获取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"）。 根据需要修改路径。

为处理诸如网络故障（FlurlHttpException）或在数据获取或PDF生产期间发生的一般异常（Exception）等问题提供强大的错误处理。 您可以使用IronPDF更改页面大小、边距、页眉、页脚及其他PDF设置。 有关更高级自定义选项，请参见IronPDF的方式手册。 在向API发送HTTP查询时，请确保安全地处理敏感数据和访问令牌。 使用您的API所需的正确身份验证方法。