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

1.1 Npgsql'nin Kullanım Avantajları

Performans: Npgsql'nin hız ve verimliliği, yerleşiktir. PostgreSQL veritabanlarıyla çalışırken optimum hız sağlamak için, komut toplama, asenkron giriş/çıkış ve optimize edilmiş veri türleri gibi yeteneklerden faydalanır.

Tam PostgreSQL Desteği: Npgsql'nin amacı, diziler, JSONB, gelişmiş veri türleri ve kullanıcı tanımlı türler gibi tüm PostgreSQL işlevselliği için tam destek sunmaktır. Bu, programcıların PostgreSQL'nin tüm potansiyelini .NET uygulamalarında kullanabilmesi 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ını sağladığı için sorgu performansını artırır ve SQL enjeksiyon saldırılarını önlemeye yardımcı olur. Npgsql, parametreli sorguları destekler. Ek olarak, parametreli sorgular dinamik SQL sorgularının güvenli ve etkili bir şekilde çalışmasını kolaylaştırır.

2.2 PostgreSQL ile Toplu İşlemler

Büyük veri kümeleriyle çalışırken, Npgsql tarafından desteklenen toplu ekleme, güncelleme ve silme eylemleri hızda büyük bir iyileşme sağlayabilir. Birden fazla satırın tek bir veritabanı işleminde işlenebilmesi sayesinde, veritabanı sunucusuna ayrı ayrı yolculuklar yapmanın ücreti azalır.

PostgreSQL ile İşlemler

Npgsql işlemleri destekler, birkaç veritabanı işleminin tek bir atomik birim olarak gruplanmasını sağlar. İşlemler, veritabanındaki tüm değişiklikleri onaylamak veya bir hata durumunda tüm işlemi geri almak suretiyle veri tutarlılığını ve bütünlüğünü sağlar.

2.3 PostgreSQL ile Performans Optimizasyonu

PostgreSQL veritabanlarıyla çalışırken, Npgsql sorgu planı önbelleğe alma, sonuç akışlandırma ve komut toplama gibi bir dizi performans geliştirmesi sunarak gecikmeyi azaltır ve verimi artırır. Bu iyileştirmeler, uygulamanın ölçeklenebilirliği ve genel hızını artırır.

2.4 PostgreSQL Veritabanına Bağlantı

Aşağıdaki birkaç satır kod yardımı ile Npgsql'yi kullanarak PostgreSQL veritabanı sunucusuna kolayca bağlanabilirsiniz.

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 Kullanmak

C# projesinde Npgsql ve IronPDF birlikte kullanıldığında heyecan verici olasılıklar ortaya çıkar. Npgsql, PostgreSQL ile çalışma konusunda büyük 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ıyla iletişim kurabilen ve bu içeriği PDF'lere dönüştürebilen uygulamalar tasarlayabilirler.

3.2 IronPDF ile PostgreSQL Verilerini Alma

Npgsql'yi kullanarak bir Windows konsol uygulaması oluşturarak, kullanıcılar uygulamanız içinde veritabanı ile etkileşimde bulunabilir. Uygulamanıza ilk olarak veritabanı erişimi ekleyin. Bu kontrol için konsolda yeterli alan olmalı, DB etkileşimleri için bolca alan bırakılmalı. Veri türü eşlemesi ve toplu işlemleri de dahil edin.

IronPDF Yükleyin

• 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 kullanarak da yükleyebilirsiniz.
  • Arama sonuçlarında IronPDF paketini bulun, seçin ve "Yükle" butonuna tıklayın. Visual Studio indirme ve yüklemeyi otomatik olarak halledecektir.

• IronPDF paketi, projeniz için gereken herhangi bir bağımlılıkla birlikte NuGet tarafından indirilecek ve yüklenecektir.
• Kurulumdan sonra, projenizde IronPDF'yi kullanmaya başlayabilirsiniz.

NuGet Web Sitesi Üzerinden Kurulum

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

DLL Kullanarak Kurulum

Alternatif olarak, IronPDF'in DLL dosyasını projenize doğrudan entegre etmek için kullanabilirsiniz. DLL içeren ZIP dosyasını indirmek için bu IronPDF ZIP paketi bağlantısını kullanın. Zip dosyasını çıkardıktan sonra, DLL'i projenize ekleyin.

Mantık Uygulaması

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

1. Veri Alma: Kullanıcı dönüştürmeyi başlattığında, Npgsql .NET sağlayıcısının en güncel içeriğini alın.
2. IronPDF ile PDF Oluştur: Npgsql veritabanındaki verileri PDF'ye dönüştürmek için IronPDF'yi kullanın. HTML dizesi, HtmlToPdf sınıfı kullanılarak bir PDF belgesine biçimlendirilebilir.
3. PDF'yi Kaydet ve Bildir: Üretilen PDF'yi belirtilen bir konuma kaydedin veya konsolda görünür bir mesaj bırakın. Kullanıcıya terminal mesajı aracılığıyla bildirin - PDF kaydedildikten sonra dönüşümün başarılı olduğunu.

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ıdaki koddan üretilen sonuç aşağıdadır. IronPDF dokümantasyonu hakkında daha fazla bilgi için kılavuza başvurun.