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

Npgsql Yükleme

Yeni oluşturduğunuz projeyi Visual Studio'da açın. Solution Explorer'da projenize sağ tıklayın, 'NuGet Paketlerini Yönet' seçeneğini seçin ve Npgsql paketini arayın. Paket isminin yanında bulunan yükleme düğmesine tıklayarak yükleyin. Bu eylem, Npgsql veri sağlayıcısını projenize ekleyerek uygulamanızın PostgreSQL ile iletişim kurmasını sağlar. Paket yöneticisi konsolunu kullanarak da kurabilirsiniz.

Veritabanı Bağlantısının Yapılandırılması

C# ile bir PostgreSQL veritabanıyla etkileşime geçmenin ilk adımı bir bağlantı kurmaktır. Bu, sunucu adı, port, kullanıcı adı ve parola gibi ayrıntıları içeren bir bağlantı dizesi gerektirir. İşte bir PostgreSQL bağlantı dizesi için temel bir şablon:

string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase";

string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase";

Dim connectionString As String = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase"

localhost, yourpassword ve mydatabase değerlerini PostgreSQL sunucunuzun ayrıntıları ile değiştirin.

Çalışan Modelinin Tanımlanması

PostgreSQL veritabanında verilerimizi temsil edecek bir Çalışan varlık modeli tanımlıyoruz. Bu model, veritabanı tablosundaki sütunlarla eşleşen özellikler içerir.

public class Employee
{
    public int Id { get; set; } // Automatically becomes the primary key
    public string LastName { get; set; }
}

public class Employee
{
    public int Id { get; set; } // Automatically becomes the primary key
    public string LastName { get; set; }
}

Public Class Employee
	Public Property Id() As Integer ' -  Automatically becomes the primary key
	Public Property LastName() As String
End Class

Bu kod parçası, iki özelliği olan basit bir Çalışan sınıfını tanımlar: Id ve Soyad. Entity Framework Core, Id seri birincil anahtar özelliğinin birincil anahtar olarak ele alınması gerektiğini anlamak için kuralları kullanır.

Uygulamanın DbContext'ini Yapılandırma

AppDbContext sınıfı, Entity Framework Core'dan DbContext'i genişleterek, C# uygulamanız ile PostgreSQL veritabanı arasında bir köprü görevi görür. Bağlantı dizesi ve veritabanındaki tabloları temsil eden DbSet özellikleri gibi yapılandırma ayrıntılarını içerir.

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; set; } // Represents the Employees table

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database";
        optionsBuilder.UseNpgsql(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Employee>().ToTable("Employees");
    }
}

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; set; } // Represents the Employees table

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database";
        optionsBuilder.UseNpgsql(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Employee>().ToTable("Employees");
    }
}

Public Class AppDbContext
	Inherits DbContext

	Public Property Employees() As DbSet(Of Employee) ' -  Represents the Employees table

	Protected Overrides Sub OnConfiguring(ByVal optionsBuilder As DbContextOptionsBuilder)
		Dim connectionString As String = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database"
		optionsBuilder.UseNpgsql(connectionString)
	End Sub

	Protected Overrides Sub OnModelCreating(ByVal modelBuilder As ModelBuilder)
		modelBuilder.Entity(Of Employee)().ToTable("Employees")
	End Sub
End Class

• DbSet Özelliği: public DbSet Employees { get; set; } , PostgreSQL veritabanında çalışan tablosuna eşlenmiş olanEmployee varlıklarını tanımlar.

• OnConfiguring Metodu: Bu yöntem, ihtiyaçı olan veritabanı bağlantı dizesiyle DbContext yapılandırmasını yapar. your_password ve your_database değerlerini gerçek PostgreSQL sunucu ayrıntılarınız ile değiştirin.

• OnModelCreating Metodu: Burada, varlık davranışlarını daha da yapılandırmak için Fluent API'ini kullanabilirsiniz. Bu örnekte, tablo adını açıkça belirtiriz, ancak tablo adı DbSet özelliği adıyla eşleşiyorsa isteğe bağlıdır.

Temel Program Mantığı

Program sınıfının Main yönteminde, veritabanının oluşturulmasını sağlar, boşsa başlangıç verileri ile doldurur ve ardından çalışan verilerini almak ve göstermek için bir sorgu gerçekleştiririz.

class Program
{
    static void Main(string[] args)
    {
        using (var context = new AppDbContext())
        {
            context.Database.EnsureCreated();  // Ensure the database and schema are created
            if (!context.Employees.Any())  // Check if the Employees table is empty
            {
                context.Employees.Add(new Employee { LastName = "Software" });
                context.SaveChanges();  // Save changes to the database
            }
            var employees = context.Employees.Where(e => e.LastName == "Software").ToList();
            foreach (var employee in employees)
            {
                Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}");
            }
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        using (var context = new AppDbContext())
        {
            context.Database.EnsureCreated();  // Ensure the database and schema are created
            if (!context.Employees.Any())  // Check if the Employees table is empty
            {
                context.Employees.Add(new Employee { LastName = "Software" });
                context.SaveChanges();  // Save changes to the database
            }
            var employees = context.Employees.Where(e => e.LastName == "Software").ToList();
            foreach (var employee in employees)
            {
                Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}");
            }
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Using context = New AppDbContext()
			context.Database.EnsureCreated() ' Ensure the database and schema are created
			If Not context.Employees.Any() Then ' Check if the Employees table is empty
				context.Employees.Add(New Employee With {.LastName = "Software"})
				context.SaveChanges() ' Save changes to the database
			End If
			Dim employees = context.Employees.Where(Function(e) e.LastName = "Software").ToList()
			For Each employee In employees
				Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}")
			Next employee
		End Using
	End Sub
End Class

Yukarıdaki kod, veritabanının var olup olmadığını kontrol eder ve yoksa şema ile birlikte oluşturur. Bu, geliştirme sırasında yeni bir veritabanı oluşturmanın doğrudan bir yoludur. Bu SQL ifadesi, Çalışanlar tablosu boşsa, programın 'Software' soyadına sahip yeni bir Çalışan ekleyip değişiklikleri veritabanına kaydettiğini kontrol eder. Program, 'Software' soyadına sahip girişleri Çalışanlar tablosunda sorgular ve ayrıntılarını konsola yazdırır.

Çıktı

İşte programı çalıştırdığınızda konsol çıktısı:

Ve işte PgAdmin'deki tablo verileri:

IronPDF Kurulumu

IronPDF'yi kullanmadan önce, projeye eklemeniz gerekir. NuGet Paket Yöneticisi aracılığıyla kolayca yapılabilir:

Install-Package IronPdf

PostgreSQL Verilerinden PDF Oluşturma

Bu örnekte, PostgreSQL veritabanımızdan çalışanları listeleyen basit bir PDF raporu oluşturalım. AppDbContext ve Çalışan modelinin önceki bölümlerde belirtildiği şekilde kurulu olduğunu varsayacağız.

Öncelikle, projenizde IronPDF kütüphanesinin kurulu olduğundan emin olun. Ardından, PostgreSQL veritabanından veri almak ve PDF raporu oluşturmak için aşağıdaki kodu kullanabilirsiniz:

class Program
{
    static void Main(string[] args)
    {
        IronPdf.License.LicenseKey = "Key";
        // Initialize the database context
        using (var context = new AppDbContext())
        {
            // Fetch employees from the database
            var employees = context.Employees.ToList();
            // Generate HTML content for the PDF
            var htmlContent = "<h1>Employee Report</h1>";
            htmlContent += "<table><tr><th>ID</th><th>Last Name</th></tr>";
            foreach (var employee in employees)
            {
                htmlContent += $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>";
            }
            htmlContent += "</table>";
            // Instantiate the IronPDF HtmlToPdf converter
            var renderer = new ChromePdfRenderer();
            // Generate the PDF document from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            // Save the generated PDF to a file
            var outputPath = "f:\\EmployeeReport.pdf";
            pdf.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated: {outputPath}");
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        IronPdf.License.LicenseKey = "Key";
        // Initialize the database context
        using (var context = new AppDbContext())
        {
            // Fetch employees from the database
            var employees = context.Employees.ToList();
            // Generate HTML content for the PDF
            var htmlContent = "<h1>Employee Report</h1>";
            htmlContent += "<table><tr><th>ID</th><th>Last Name</th></tr>";
            foreach (var employee in employees)
            {
                htmlContent += $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>";
            }
            htmlContent += "</table>";
            // Instantiate the IronPDF HtmlToPdf converter
            var renderer = new ChromePdfRenderer();
            // Generate the PDF document from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            // Save the generated PDF to a file
            var outputPath = "f:\\EmployeeReport.pdf";
            pdf.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated: {outputPath}");
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		IronPdf.License.LicenseKey = "Key"
		' Initialize the database context
		Using context = New AppDbContext()
			' Fetch employees from the database
			Dim employees = context.Employees.ToList()
			' Generate HTML content for the PDF
			Dim htmlContent = "<h1>Employee Report</h1>"
			htmlContent &= "<table><tr><th>ID</th><th>Last Name</th></tr>"
			For Each employee In employees
				htmlContent &= $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>"
			Next employee
			htmlContent &= "</table>"
			' Instantiate the IronPDF HtmlToPdf converter
			Dim renderer = New ChromePdfRenderer()
			' Generate the PDF document from the HTML content
			Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
			' Save the generated PDF to a file
			Dim outputPath = "f:\EmployeeReport.pdf"
			pdf.SaveAs(outputPath)
			Console.WriteLine($"PDF report generated: {outputPath}")
		End Using
	End Sub
End Class

Çıktı

Kodu çalıştırdığınızda, bu konsol çıktısı gösterilecektir:

Bu PDF oluşturuldu: