Npgsql, geliştiricilerin veritabanlarıyla çalışmak için güçlü yollar ararken, .NET uygulamaları ile PostgreSQL veritabanları arasında sorunsuz iletişimi sağlayan önemli bir teknolojidir. .NET Data Provider for PostgreSQL server, veya Npgsql, veritabanı bağlantısı alanında yaratıcılık, etkinlik ve esneklik sembolüdür. C#, Visual Basic ve F# kullanıcılarının veritabanına erişmesine olanak tanır. EF Core kullanıcıları için de eski bir entity framework 6.x mevcuttur.

IronPDF adlı popüler bir .NET kütüphanesi, C# ve VB.NET programlarında PDF belgeleri oluşturmak, modifiye etmek ve görüntülemek için kullanılır. Birçok PDF'yi birleştirmek, filigran eklemek ve mevcut PDF dosyalarından metin veya resim çıkarmak gibi ileri düzeyde görevleri gerçekleştirmenin yanı sıra, geliştiricilerin HTML, fotoğraflar ve ham metin gibi çeşitli kaynaklardan PDF dosyaları oluşturmasına olanak tanır.

Bu öğreticiyi izleyerek, bir C# uygulamasında IronPDF ve NPGSQL'yi nasıl entegre edeceğinizi öğreneceksiniz. Basit kurulumdan ileri düzey özelliklere kadar bu araçların, uygulamanızın işlevselliğini nasıl artırabileceği yollarını araştıracağız.

Npgsql Nasıl Kullanılır

1. Yeni bir C# projesi oluşturun
2. Npgsql kütüphanesini yükleyin.
3. Npgsql veritabanına bağlanın.
4. Sorguyu çalıştırın ve sonucu alın.
5. Sonucu işleyin ve bağlantıyı kapatın.

1. Npgsql'ye Giriş

Temelde, Npgsql, kararlılığı, ölçeklenebilirliği ve genişletilebilirliği ile tanınan açık kaynaklı bir ilişkisel veritabanı yönetim sistemi olan PostgreSQL ile .NET geliştiricileri arasında bağlantı işlevi görür. Npgsql, kapsamlı bir özellik seti sunarak geliştiricilere işlemleri ele alma, sorgu yapma, veri alma ve veritabanı işlemlerini eşi görülmemiş bir kolaylık ve verimlilik düzeyinde kolaylaştırma yeteneği verir.

1.1 Npgsql Kullanmanın Avantajları

Performans: Npgsql'nin hızı ve verimliliği yapılandırılmıştır. PostgreSQL veritabanları ile çalışırken optimum hız sağlamak için komutları paketleme, asenkron giriş/çıkış ve optimize edilmiş veri tipleri gibi özelliklerden yararlanır.

Tam PostgreSQL Desteği: Npgsql'nin amacı, diziler, JSONB, gelişmiş veri tipleri ve kullanıcı tanımlı tipler gibi tüm PostgreSQL işlevsellikleri için eksiksiz destek sağlamaktır. Bu, programcıların PostgreSQL'in tam potansiyelini .NET uygulamalarında kullanabilecekleri anlamına gelir.

1.2 Npgsql ile Başlarken

1.2.1 Npgsql'nin C# Projelerinde Kurulumu

Bir C# projesine Npgsql eklemek basittir. Npgsql eklemek için Microsoft'un .NET paket yönetimi olan NuGet kullanılır. Bu kütüphane, bir PostgreSQL veritabanını projelerinize Npgsql ile entegre etmek için gerekli araçları ve kitaplıkları sunar.

1.2.2 Npgsql'nin Windows konsolu ve formlarında uygulanması

Windows Forms (WinForms) ve Windows konsolu gibi birkaç C# uygulama türü Npgsql'yi kullanabilir. Her çerçevenin uygulanması farklılık gösterse de, temel fikir her zaman aynı: Npgsql, uygulamanızın içinde bir veritabanı için bir kapsayıcı görevi görür.

1.2.3 Npgsql'den Veri Alma Üzerine Temel Bir Örnek

PostgreSQL veritabanı ile çalışmadan önce Npgsql ile bir bağlantı kurun. Ardından, PostgreSQL'den veri almak için SQL sorguları çalıştırın. NpgsqlCommand, SQL sorgularını çalıştırmak için bir araçtır.

using Npgsql;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        // Create connection object
        using (var conn = new NpgsqlConnection(connString))
        {
            // Open the connection
            await conn.OpenAsync();

            // SQL query to execute
            string sql = "SELECT * FROM myTable";

            // Create NpgsqlCommand
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                // Execute the command and retrieve data
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    // Loop through the retrieved data
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);
                        // Output retrieved data to console
                        Console.WriteLine($"Name: {name}, Age: {age}");
                    }
                }
            }
            // Connection will be automatically closed here due to the 'using' block
        }
    }
}

using Npgsql;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        // Create connection object
        using (var conn = new NpgsqlConnection(connString))
        {
            // Open the connection
            await conn.OpenAsync();

            // SQL query to execute
            string sql = "SELECT * FROM myTable";

            // Create NpgsqlCommand
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                // Execute the command and retrieve data
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    // Loop through the retrieved data
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);
                        // Output retrieved data to console
                        Console.WriteLine($"Name: {name}, Age: {age}");
                    }
                }
            }
            // Connection will be automatically closed here due to the 'using' block
        }
    }
}

Imports Npgsql
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' PostgreSQL connection string
		Dim connString As String = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase"

		' Create connection object
		Using conn = New NpgsqlConnection(connString)
			' Open the connection
			Await conn.OpenAsync()

			' SQL query to execute
			Dim sql As String = "SELECT * FROM myTable"

			' Create NpgsqlCommand
			Using cmd = New NpgsqlCommand(sql, conn)
				' Execute the command and retrieve data
				Using reader = Await cmd.ExecuteReaderAsync()
					' Loop through the retrieved data
					Do While Await reader.ReadAsync()
						' Retrieve data from the data reader
						Dim name As String = reader("Name").ToString()
						Dim age As Integer = Convert.ToInt32(reader("Age"))
						' Output retrieved data to console
						Console.WriteLine($"Name: {name}, Age: {age}")
					Loop
				End Using
			End Using
			' Connection will be automatically closed here due to the 'using' block
		End Using
	End Function
End Class

Imports Npgsql
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' PostgreSQL connection string
		Dim connString As String = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase"

		' Create connection object
		Using conn = New NpgsqlConnection(connString)
			' Open the connection
			Await conn.OpenAsync()

			' SQL query to execute
			Dim sql As String = "SELECT * FROM myTable"

			' Create NpgsqlCommand
			Using cmd = New NpgsqlCommand(sql, conn)
				' Execute the command and retrieve data
				Using reader = Await cmd.ExecuteReaderAsync()
					' Loop through the retrieved data
					Do While Await reader.ReadAsync()
						' Retrieve data from the data reader
						Dim name As String = reader("Name").ToString()
						Dim age As Integer = Convert.ToInt32(reader("Age"))
						' Output retrieved data to console
						Console.WriteLine($"Name: {name}, Age: {age}")
					Loop
				End Using
			End Using
			' Connection will be automatically closed here due to the 'using' block
		End Using
	End Function
End Class

Yukarıdaki kod parçasında, Npgsql'den verileri alıyor ve konsolda gösteriyoruz. Aşağıdaki görsel, çalıştırılan sorgunun sonucunu göstermektedir.

2. PostgreSQL ile Npgsql İşlemleri

2.1 PostgreSQL ile Parametreli Sorgular

Parametreli sorgular, veritabanı sunucusunun sorgu planlarını önbelleğe almasına olanak tanıdığı için sorgu performansını artırır ve SQL enjeksiyon saldırılarına karşı koruma sağlar. Npgsql, parametreli sorguları destekler. Ek olarak, dinamik SQL sorguları ile güvenli ve etkili bir şekilde çalışmak parametreli sorgularla daha kolay hale gelir.

2.2 PostgreSQL ile Toplu İşlemler

Büyük veri kümeleri ile çalışırken, Npgsql'nin desteklediği toplu ekleme, güncelleme ve silme işlemleri hızı büyük ölçüde artırabilir. Birden fazla satırın tek bir veritabanı işleminde işlenebilmesi sayesinde toplu işlemler, veritabanı sunucusuna yapılan ayrı ayrı gidiş-dönüşlerin yükünü azaltır.

PostgreSQL ile İşlemler

Npgsql, birkaç veritabanı işlemini tek bir atomik birime gruplayarak işlemleri destekler. İşlemler, tüm değişiklikleri veritabanına kaydederek veya bir hata durumunda tüm işlemi geri alarak veri tutarlılığı ve bütünlüğü sağlar.

2.3 PostgreSQL ile Performans Optimizasyonu

Npgsql, PostgreSQL veritabanları üzerinde çalışırken gecikmeyi azaltmak ve veri aktarım hızını arttırmak için sorgu planı önbelleğe alma, sonuç akışı ve komut toplama gibi bir dizi performans artırımı sunar. Bu iyileştirmeler, uygulamanın ölçeklenebilirliğini ve genel hızını artırır.

2.4 PostgreSQL Veritabanı ile Bağlantı

Npgsql yardımıyla PostgreSQL veritabanı sunucusuna kolaylıkla bir bağlantı yapılabilir.

NpgsqlConnection conn = new NpgsqlConnection(connString);

NpgsqlConnection conn = new NpgsqlConnection(connString);

Dim conn As New NpgsqlConnection(connString)

Dim conn As New NpgsqlConnection(connString)

Bu temel kod parçası, PostgreSQL veritabanı sunucusuna bağlanmamıza yardımcı olur.

3. Npgsql ile IronPDF Entegrasyonu

3.1 Npgsql ve IronPDF'yi Birlikte Kullanma

Npgsql ve IronPDF, bir C# projesinde bir arada kullanıldığında heyecan verici olanaklar ortaya çıkar. Npgsql, PostgreSQL ile çalışmak için harika bir araçken, IronPDF bu içeriği PDF'lere dönüştürmek için harika bir araçtır. Bu bağlantı sayesinde, programcılar veritabanları ile iletişim kurabilen ve bu içeriği PDF'lere dönüştürme yeteneğine sahip uygulamalar tasarlayabilirler.

3.2 IronPDF ile PostgreSQL Verilerini Alma

Npgsql kullanan bir Windows konsol uygulaması oluşturarak kullanıcılar, uygulama içinde veritabanıyla etkileşimde bulunabilir. Önce uygulamanıza veritabanı erişimi ekleyin. Konsolda bu kontrol için yeterli alan bırakılmalı ve veritabanı etkileşimleri için bolca alan ayrılmalıdır. Ayrıca veri türü eşlemesi ve toplu işlemler de ekleyin.

IronPDF Kurulumu

• Projeyi Visual Studio'da başlatın.

• "Araçlar" > "NuGet Paket Yöneticisi" > "Paket Yöneticisi Konsolu" nu seçin.

  • Paket Yöneticisi Konsoluna aşağıdaki komutu girin ve Enter tuşuna basın:

    PM > Install-Package IronPdf

• Alternatif olarak, IronPDF'yi Çözümler için NuGet Paket Yöneticisi'ni kullanarak da yükleyebilirsiniz.

  • Arama sonuçlarında IronPDF paketini bulun, seçin ve ardından "Yükle" düğmesine tıklayın. Visual Studio, indirme ve kurulumu otomatik olarak halleder.

• NuGet, projeniz için gerekli olan bağımlılıklarla birlikte IronPDF paketini indirip yükleyecektir.
• Yükleme işlemi tamamlandıktan sonra, projenizde IronPDF kullanmaya başlayabilirsiniz.

NuGet Web Sitesi Üzerinden Yükleme

IronPDF hakkında daha fazla bilgi için, özellikler, uyumluluk ve diğer indirme seçenekleri dahil NuGet üzerindeki IronPDF paketine gidin.

DLL kullanarak Yükleme

Alternatif olarak, IronPDF'in DLL dosyasını doğrudan projenize dahil etmek için kullanabilirsiniz. DLL içeren ZIP dosyasını indirmek için bu IronPDF ZIP paketi bağlantısını kullanın. Sıkıştırmasını açtıktan sonra, DLL'yi projenize ekleyin.

Mantığı Uygulama

Uygulamayı çalıştırmaya başladığımızda, veri tabanından verileri Npgsql .NET kütüphanesi kullanarak alacaktır. IronPDF'nin yardımıyla, veritabanı içeriğini bir PDF belgesine dönüştürme yeteneğine sahibiz.

1. Veri Alma: Kullanıcı dönüşümü başlattığında, Npgsql .NET sağlayıcısından en son içeriği alın.
2. IronPDF ile PDF Oluşturma: Npgsql veritabanından alınan verileri PDF'ye dönüştürmek için IronPDF'yi kullanın. HtmlToPdf sınıfı, HTML dizesinin bir PDF belgesine biçimlendirilmesine olanak tanır.
3. PDF'yi Kaydet ve Bildir: Üretilen PDF'yi belirli bir konuma kaydedin veya konsolda görünür bir mesaj bırakın. Kullanıcıyı bilgilendirin - belki bir terminal mesajı yoluyla - PDF kaydedildikten sonra dönüşümün başarılı olduğu konusunda.

using Npgsql;
using IronPdf;
using System;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // StringBuilder for HTML content
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");

        // PostgreSQL connection setup
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        using (var conn = new NpgsqlConnection(connString))
        {
            await conn.OpenAsync();

            string sql = "SELECT * FROM myTable";
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);

                        // Add data to the PDF
                        sb.Append($"<p>Name: {name}, Age: {age}</p>");
                    }
                }
            }

            // Generate and save the PDF document
            var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
            pdf.SaveAs("output.pdf");

            // Connection will be automatically closed here
        }

        Console.WriteLine("PDF generation completed. See output.pdf for results.");
    }
}

using Npgsql;
using IronPdf;
using System;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // StringBuilder for HTML content
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");

        // PostgreSQL connection setup
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        using (var conn = new NpgsqlConnection(connString))
        {
            await conn.OpenAsync();

            string sql = "SELECT * FROM myTable";
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);

                        // Add data to the PDF
                        sb.Append($"<p>Name: {name}, Age: {age}</p>");
                    }
                }
            }

            // Generate and save the PDF document
            var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
            pdf.SaveAs("output.pdf");

            // Connection will be automatically closed here
        }

        Console.WriteLine("PDF generation completed. See output.pdf for results.");
    }
}

Imports Npgsql
Imports IronPdf
Imports System
Imports System.Text
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' StringBuilder for HTML content
		Dim sb As New StringBuilder()
		Dim Renderer = New ChromePdfRenderer() ' Instantiates Chrome Renderer

		sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>")

		' PostgreSQL connection setup
		Dim connString As String = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase"

		Using conn = New NpgsqlConnection(connString)
			Await conn.OpenAsync()

			Dim sql As String = "SELECT * FROM myTable"
			Using cmd = New NpgsqlCommand(sql, conn)
				Using reader = Await cmd.ExecuteReaderAsync()
					Do While Await reader.ReadAsync()
						' Retrieve data from the data reader
						Dim name As String = reader("Name").ToString()
						Dim age As Integer = Convert.ToInt32(reader("Age"))

						' Add data to the PDF
						sb.Append($"<p>Name: {name}, Age: {age}</p>")
					Loop
				End Using
			End Using

			' Generate and save the PDF document
			Dim pdf = Renderer.RenderHtmlAsPdf(sb.ToString())
			pdf.SaveAs("output.pdf")

			' Connection will be automatically closed here
		End Using

		Console.WriteLine("PDF generation completed. See output.pdf for results.")
	End Function
End Class

Imports Npgsql
Imports IronPdf
Imports System
Imports System.Text
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' StringBuilder for HTML content
		Dim sb As New StringBuilder()
		Dim Renderer = New ChromePdfRenderer() ' Instantiates Chrome Renderer

		sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>")

		' PostgreSQL connection setup
		Dim connString As String = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase"

		Using conn = New NpgsqlConnection(connString)
			Await conn.OpenAsync()

			Dim sql As String = "SELECT * FROM myTable"
			Using cmd = New NpgsqlCommand(sql, conn)
				Using reader = Await cmd.ExecuteReaderAsync()
					Do While Await reader.ReadAsync()
						' Retrieve data from the data reader
						Dim name As String = reader("Name").ToString()
						Dim age As Integer = Convert.ToInt32(reader("Age"))

						' Add data to the PDF
						sb.Append($"<p>Name: {name}, Age: {age}</p>")
					Loop
				End Using
			End Using

			' Generate and save the PDF document
			Dim pdf = Renderer.RenderHtmlAsPdf(sb.ToString())
			pdf.SaveAs("output.pdf")

			' Connection will be automatically closed here
		End Using

		Console.WriteLine("PDF generation completed. See output.pdf for results.")
	End Function
End Class

Yukarıda verilen koddan elde edilen sonuç aşağıda verilmiştir. IronPDF belgelerine başvurarak kılavuzu inceleyebilirsiniz.

Sonuç

IronPDF'nin PDF oluşturma yetenekleri ve Npgsql PostgreSQL veritabanı bağlantısı sayesinde, geliştiriciler, benzersiz ihtiyaçlarını karşılayan dinamik PDF belgeleri üreten esnek ve sağlam çözümler tasarlayabilir.

$999 Lite paketi, kalıcı bir lisans ve bir yıllık yazılım desteğinin yanı sıra yükseltme seçenekleri içerir. IronPDF, ücretsiz lisanslama seçeneği sunmaktadır. Iron Software'in diğer ürünleri hakkında bilgi edinmek için, ürün sayfalarını keşfedin.

IronPDF ayrıca çeşitli özelliklerini kullanmak için kapsamlı belgeler ve PDF üretimi ve manipulasyonu için aktif olarak sürdürülen kod örnekleri sunar.