Npgsql C# (Geliştiriciler için Nasıl Çalışır)

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

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

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)

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

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:

  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

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