Flurl C# (Geliştiriciler İçin Nasıl Çalışır)

Akıcı Arayüz

Flurl tarafından sağlanan akıcı, zincirlenebilir söz dizimi, programın okunabilirliğini ve sürdürülebilirliğini artırır. Geliştiriciler, URL'ler, sorgu parametreleri, başlıklar ve yüklerle çalışırken basit ve ifadeli HTTP istekleri oluşturabilir.

HTTP Yöntem Desteği

GET, POST, PUT, DELETE, PATCH, HEAD ve OPTIONS gibi tüm standart HTTP yöntemleri desteklenir. Web API'leriyle çalışırken geliştiricilerin çeşitli görevleri gerçekleştirmesine olanak tanıyan bu kapsayıcı destek yaklaşımıdır.

Sorgu Parametresi İşleme

Flurl, URL'ler içindeki sorgu parametrelerini değiştirmek, eklemek ve kaldırmak için kolay yollar sunar. Kullanıcı girdisi veya çalışma zamanı durumlarına dayalı olarak dinamik URL'ler oluşturmayı kolaylaştırır.

JSON Desteği

JSON veri işleme, Flurl tarafından yerel olarak desteklenir. JSON yanıtlarını C# nesnelerine kolayca deserializasyon yapabilir ve istek yükleri için nesneleri JSON'a serileştirebilir. Bunun sayesinde, JSON tabanlı API'leri kullanmak basit ve kolaydır.

Form Verileri ve Çok Parçalı Destek

Çok parçalı istekleri ve form verilerini yönetmeyi kolaylaştırır. Flurl, geliştiricilerin multipart/form-data yükleri veya form-encoded verileri HTTP isteklerine dahil etmesini basit hale getirir.

Hata Yönetimi ve Yeniden Deneme Politikaları

Flurl, tüm HTTP çağrıları için hata yönetimi ve yeniden deneme politikası tanımlama yetenekleri sunar. Geliştiriciler, benzersiz hata yönetimi mantığı veya yeniden deneme teknikleri tanımlayarak API çağrılarının ve etkileşimlerinin dayanıklılığını ve güvenilirliğini artırabilir. Bu aynı zamanda geliştiricilerin yanıtlardaki anonim nesne hatalarından korunmasına yardımcı olur.

Kimlik Doğrulama

OAuth, özel kimlik doğrulama şemaları, Temel Kimlik Doğrulama ve API anahtarları gibi birçok popüler kimlik doğrulama yöntemlerini destekler. Bu, kimlik doğrulama gerektiren API'lerle güvenli iletişim sağlar.

Test Desteği

HTTP ile ilgili mantığı tekrar kullanılabilir bileşenlere ayıran Flurl, test edilebilirliği teşvik eder. Bu, API etkileşimleri için birim testleri yazmayı daha kolay hale getirir, çünkü bunları test etmek için gerçek ağ çağrılarına gerek yoktur.

Yapılandırma Esnekliği

HTTP istemcileri ve istek parametreleri için yapılandırma esnekliği sağlar. Geliştiriciler, belirli uygulamaların veya API sınırlamalarının ihtiyaçlarına uygun olacak şekilde istemci davranışlarını, zaman aşımı sürelerini, hata yanıt miktarlarını, başlıkları ve diğer ayarları değiştirebilir.

Genişletilebilirlik

Eklenti çerçevesi sayesinde, Flurl oldukça genişletilebilir. Geliştiriciler, platformun işlevselliğini artırmak için özel genişletmeler oluşturabilir veya yeni özellikler için üçüncü taraf eklentiler ekleyebilir.

Yeni Bir Visual Studio Projesi Oluşturma

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 nedir?

IronPDF adlı zengin özelliklere sahip .NET kütüphanesi, PDF belgeleri oluşturmak, okumak ve değiştirmek için C# programlarında mevcuttur. Bu araç sayesinde geliştiriciler, HTML, CSS ve JavaScript içeriğinden hızlıca baskıya hazır, yüksek kaliteli PDF'ler üretebilir. Bazı temel yetenekler, filigran ekleme, başlık ve altbilgiler oluşturma, PDF'leri bölme ve birleştirme ve HTML'yi PDF'ye dönüştürme kapasitesini içerir. IronPDF, .NET Framework ve .NET Core'u destekler, bu da onu çeşitli uygulamalar için kullanışlı kılar.

PDF'ler, kolayca entegre edilir ve ayrıntılı belge zenginliğiyle, geliştiriciler bunları uygulamalarında kolayca kullanabilir. IronPDF, karmaşık düzen ve stil işlemlerini verimli bir şekilde yöneterek oluşturan PDF'lerin kaynak HTML içeriğine yakından benzemesini sağlar.

IronPDF, web sayfalarını, URL'leri ve HTML'yi, orijinal içeriğe tam olarak benzeyen yüksek kaliteli PDF'lere dönüştürmeyi çok basit hale getirir. Çevrimiçi raporlar, faturalar ve daha fazlası için PDF oluşturmak için mükemmeldir. HTML'yi PDF'ye dönüştürmenin bir yolunu arıyorsanız, IronPDF sizin için burada!

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'nin Özellikleri

HTML'den PDF Üretimi

[79] JavaScript, HTML ve CSS'yi PDF'ye dönüştürün. Medya sorgularını ve duyarlı tasarımı, iki çağdaş web standardını destekler. HTML ve CSS ile PDF raporları, faturalar ve belgeleri dinamik olarak süslemek için kullanışlıdır.

PDF Düzenleme

Önceden var olan PDF belgelerine metin, fotoğraf ve başka içerikler eklenebilir. PDF dosyalarından metin ve resimler kaldırılabilir. Birçok PDF bir dosyada birleştirilebilir. PDF dosyaları çoklu ayrı belgeye bölünebilir. Su muhabereleri, açıklamalar, başlıklar ve altbilgiler eklenebilir.

PDF Dönüştürme

Word, Excel ve görüntü dosyaları dahil olmak üzere çeşitli dosya türlerini PDF formatına dönüştürün. PDF'den görüntüye dönüştürme (PNG, JPEG, vb.).

Performans ve Güvenilirlik

Endüstriyel ortamlarda yüksek performans ve güvenilirlik istenen tasarım özellikleridir, çünkü geniş belge koleksiyonlarını etkili bir şekilde yönetebilirler.

IronPDF Yükleyin

.NET projelerinde PDF'lerle çalışmak için ihtiyaçınız olan araçlara sahip olmak için IronPDF paketini yükleyin.

Install-Package IronPdf

Flurl kullanarak veri alıp bir PDF oluşturma

HTTP sorguları yapmak ve API'nizden veri almak için Flurl'un akıcı API'sini kullanın. Bu, JSON verilerini almanın bir örneğidir:

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

Bu örnekte, Flurl'un .GetJsonAsync() fonksiyonu, bir GET isteği göndermek ve JSON verilerini almak için kullanılır. User ile API yanıt yapısını temsil eden model sınıfınızı, "URL" ile gerçek API uç noktanızı değiştirin. Bir HTML şablonunu (htmlTemplate) IronPDF'nin ChromePdfRenderer sınıfını kullanarak bir PDF belgesine dönüştürebilirsiniz. API'den alınan başlık ve gövde verileri burada HTML şablonunu dinamik olarak oluşturmak için kullanılır. Oluşturulan PDF belgesi (pdfDocument), dosya sisteminde belirtilen konuma ("document.pdf") kaydedilir. Gerekirse yolu değiştirin.

Veri alma veya PDF üretimi sırasında ağ hataları (FlurlHttpException) veya genel istisnalar (Exception) gibi sorunlar için sağlam hata yönetimi sağlayın. IronPDF kullanarak sayfa boyutu, kenar boşlukları, üstbilgiler, altbilgiler ve diğer PDF ayarlarını değiştirebilirsiniz. Daha gelişmiş özelleştirme olanakları için IronPDF kullanım kılavuzuna bakın. API'lere HTTP sorguları gönderirken, hassas verilerin ve erişim belirteçlerinin güvenli bir şekilde işlendiğinden emin olun. API'nizin gerektirdiği uygun kimlik doğrulama yöntemlerini kullanın.