Entity Framework Core (Geliştiriciler İçin Nasıl Çalışır)

Entity Framework Core'u Anlamak

Entity Framework Core, popüler Entity Framework veri erişim teknolojisinin açık kaynaklı, hafif ve genişletilebilir bir versiyonudur. Çapraz platform çalışacak şekilde tasarlanmıştır, SQL Server, SQLite, MySQL, PostgreSQL, Azure Cosmos DB ve daha fazlası dahil olmak üzere çeşitli mevcut veritabanı sunucu sağlayıcılarını destekler. EF Core modern bir nesne-veritabanı eşleyicisidir ve ORM (Nesne-İlişkisel Eşleme) desenini takip eder, geliştiricilerin .NET nesneleri kullanarak veritabanlarıyla çalışmasına olanak tanır, bu da elle sıkıcı SQL sorguları yazma ihtiyaçını ortadan kaldırır.

EF Core'un Anahtar Özellikleri

1. Varlık Modelleme: EF Core geliştiricilerin Düz Eski CLR Nesneleri (POCO'lar) kullanarak veri modelleri tanımlamasına olanak tanır. Bu varlık sınıfları, veritabanı tablolarını temsil eder, özellikler tablo sütunlarına eşlenir.

2. LINQ Desteği: EF Core, LINQ sorgularını (Dil Entegre Edilmiş Sorgu) sorunsuz bir şekilde destekler, geliştiricilerin tanıdık C# söz dizimi kullanarak SQL Server veya başka bir veritabanına karşı güçlü yazılmış sorgular yazmasına olanak tanır. Bu, veri sorgulamayı sezgisel hale getirir ve çalışma zamanı hatalarının olasılığını azaltır. Ayrıca, ham SQL ifadeleri de LINQ sorguları ile kullanılabilir.

3. Veritabanı Geçişleri: Veritabanı şema değişikliklerini yönetmek zorlu olabilir, özellikle bir takım ortamında. EF Core, veritabanı geçiş yetenekleri sağlayarak bu süreci basitleştirir, geliştiricilerin kod-öncelikli geçişleri kullanarak veritabanı şemasına artımlı değişiklikler uygulamasına olanak tanır.

4. Tembel Yükleme ve Hızlı Yükleme: EF Core hem tembel yükleme hem de hızlı yükleme stratejilerini destekler, geliştiricilerin kullanım durumuna bağlı olarak ilgili verileri talep üzerine veya önceden yükleyerek performansı optimize etmesine olanak tanır.

5. İşlem Yönetimi: İşlemler, veritabanı operasyonları sırasında veri tutarlılığını ve bütünlüğünü sağlar. EF Core, geliştiricilerin işlemlerle açıkça çalışmasına olanak tanır, böylece bir grup veritabanı operasyonunun birlikte başarılı veya başarısız olmasını sağlar.

6. Eşzamanlılık Kontrolü: EF Core, çoklu kullanıcıların aynı veriyi aynı anda değiştirmeye çalıştığında ortaya çıkabilecek eşzamanlılık çatışmalarını yönetmek için yerleşik destek sağlar.

EF Core ile Başlarken

ASP.NET Core uygulamasında Entity Framework Core (EF Core) ile SQLite kullanmanın temel bir örneğini oluşturun. İşte adımlar:

1. Uygulamanızı Oluşturun:

   • Bir Konsol veya ASP.NET uygulaması oluşturarak başlayın.

2. Gerekli Paketleri Yükleyin:

   • Projenize aşağıdaki NuGet paketlerini ekleyin:

     • Microsoft.EntityFrameworkCore (sürüm 1.0.0 veya sonrası)
     • Microsoft.EntityFrameworkCore.Sqlite (sürüm 1.0.0 veya sonrası)

3. Veritabanı Bağlamınızı Oluşturun:

   • Veritabanı bağlamınız için bir sınıf tanımlayın (örneğin, DatabaseContext) ve DbContext'den miras alın.

   • OnConfiguring metodunda SQLite bağlantı dizesini belirleyin:

     public class DatabaseContext : DbContext
     {
      protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
      {
          optionsBuilder.UseSqlite("Filename=sample.db");
      }
     }

     public class DatabaseContext : DbContext
     {
      protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
      {
          optionsBuilder.UseSqlite("Filename=sample.db");
      }
     }

     Public Class DatabaseContext
     	Inherits DbContext
     
      Protected Overrides Sub OnConfiguring(ByVal optionsBuilder As DbContextOptionsBuilder)
     	 optionsBuilder.UseSqlite("Filename=sample.db")
      End Sub
     End Class

     $vbLabelText   $csharpLabel

4. Bağlamı Kaydedin:

   • Startup sınıfınızda, bağlamınızı hizmetlere ekleyin:

     public void ConfigureServices(IServiceCollection services)
     {
      services.AddEntityFrameworkSqlite().AddDbContext<DatabaseContext>();
     }

     public void ConfigureServices(IServiceCollection services)
     {
      services.AddEntityFrameworkSqlite().AddDbContext<DatabaseContext>();
     }

     Public Sub ConfigureServices(ByVal services As IServiceCollection)
      services.AddEntityFrameworkSqlite().AddDbContext(Of DatabaseContext)()
     End Sub

     $vbLabelText   $csharpLabel

5. Başlatmada Veritabanını Oluşturun:

   • Startup yapıcısında veritabanınızı oluşturun:

     public Startup(IHostingEnvironment env)
     {
      using (var client = new DatabaseContext())
      {
          client.Database.EnsureCreated();
      }
     }

     public Startup(IHostingEnvironment env)
     {
      using (var client = new DatabaseContext())
      {
          client.Database.EnsureCreated();
      }
     }

     'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
     'ORIGINAL LINE: public Startup(IHostingEnvironment env)
     Public Sub New(ByVal env As IHostingEnvironment)
      Using client = New DatabaseContext()
     	 client.Database.EnsureCreated()
      End Using
     End Sub

     $vbLabelText   $csharpLabel

6. Uygulamanızda SQLite'ı Kullanın:

   • Şimdi ASP.NET Core uygulamanızda EF Core aracılığıyla SQLite kullanabilirsiniz.
   • Modellerinizi tanımlayın ve veritabanı ile etkileşimde bulunmak için DatabaseContext kullanın.

Bu temel bir örnek olduğunu unutmayın ve bağlantı dizesini yapılandırmanın ve EF Core'u kullanmanın başka yolları da vardır. Daha gelişmiş özelliklerde keşfetmekten ve bunu özel ihtiyaçlarınıza adapte etmekten çekinmeyin!

EF Core Geliştirmesi için En İyi Uygulamalar

1. DbContext'i Kapsamda Tutun: EF Core'daki DbContext örnekleri kısa ömürlü olacak şekilde tasarlanmıştır ve genellikle web uygulamalarında tek bir isteğin ömrüne kapsanmalıdır.

2. Sadece Okuma İşlemleri için AsNoTracking Kullanın: Varlıkların değiştirilmesi beklenmediğinde sadece okuma işlemleri yaparken, değişiklik izlemenin atlanması ile performansı artırmak için AsNoTracking metodunu kullanın.

3. Sorguları Optimize Edin: Veritabanından alınan veri miktarını en aza indirmek için uygun indeksleme, sayfalama ve filtreleme teknikleri kullanarak verimli sorgular yazın.

4. N+1 Sorgu Sorunlarından Kaçının: Bir koleksiyondaki her bir ilgili varlık için bir sorgu çalıştırılan N+1 sorgu problemine dikkat edin. İlgili verileri verimli bir şekilde almak için hızlı yükleme veya açık yükleme kullanın.

5. Performansı İzleyin: Performans darboğazlarını tanımlamak ve çözmek için Entity Framework Profiler gibi araçlar veya yerleşik günlük kaydetme yetenekleri kullanarak EF Core performansını izleyin.

IronPDF'ye Giriş

IronPDF, .NET projelerinde PDF belgelerini oluşturmanıza, düzenlemenize ve içeriği çıkarmanıza olanak tanıyan güçlü bir C# PDF kütüphanesidir. İşte bazı temel özellikler:

1. HTML'den PDF'ye Dönüşüm:

   • HTML, CSS ve JavaScript içeriğini PDF formatına dönüştürün.
   • Piksel mükemmel PDF'ler için Chrome İşleme Motorunu kullanın.
   • URL'lerden, HTML dosyalarından veya HTML dizgilerinden PDF'ler üretin.

2. Görüntü ve İçerik Dönüşümü:

   • Resimleri PDF'ye ve PDF'den dönüştürün.
   • Mevcut PDF'lerden metin ve resimler çıkarın.
   • Çeşitli resim formatları için destek.

3. Düzenleme ve Manipülasyon:

   • PDF'ler için özellikler, güvenlik ve izinler ayarlayın.
   • Dijital imzalar ekleyin.
   • Meta verileri ve revizyon geçmişini düzenleyin.

4. Çapraz Platform Desteği:

   • .NET Core (8, 7, 6, 5 ve 3.1+), .NET Standard (2.0+) ve .NET Framework (4.6.2+) ile çalışır.
   • Windows, Linux ve macOS ile uyumludur.
   • Kolay kurulum için NuGet üzerinde mevcuttur.

IronPDF ile EF Core'u birleştirerek PDF belgesi oluşturun

Başlangıçta, göründüğü gibi Visual Studio kullanarak bir Konsol uygulaması oluşturun.

Proje Adı sağlayın.

.NET çapraz platform sürümü sağlayın.

Microsoft.EntityFrameworkCore paketini yükleyin.

Microsoft.EntityFrameworkCore.SqlLite paketini yükleyin.

IronPDF paketini yükleyin.

Aşağıdaki kodu Program.cs'ye ekleyin.

using IronPdf;
using Microsoft.EntityFrameworkCore;
using System;
using System.Linq;

namespace CodeSample
{
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("-------------Demo EF core and IronPDF--------------");

            // Disable local disk access or cross-origin requests
            Installation.EnableWebSecurity = true;

            // Instantiate Renderer
            var renderer = new ChromePdfRenderer();

            // Start with initial HTML content
            var content = "<h1>Demo EF core and IronPDF</h1>";
            content += "<h2>Add Students</h2>";

            // Add Students to Database
            using (var client = new DatabaseContext())
            {
                client.Database.EnsureCreated(); // Create table if it doesn't exist
                client.Students.ExecuteDelete(); // Ensure the table is clean

                // Define students
                var students = new[]
                {
                    new Student { StudentName = "Bill", DateOfBirth = new DateTime(1990, 12, 01), Height = 5.45M, Weight = 56, Grade = 10 },
                    new Student { StudentName = "Mike", DateOfBirth = new DateTime(1992, 12, 06), Height = 4.45M, Weight = 34, Grade = 8 },
                    new Student { StudentName = "Peter", DateOfBirth = new DateTime(1990, 12, 03), Height = 5.0M, Weight = 50, Grade = 10 },
                    new Student { StudentName = "Bob", DateOfBirth = new DateTime(1990, 12, 09), Height = 4.56M, Weight = 56, Grade = 10 },
                    new Student { StudentName = "Harry", DateOfBirth = new DateTime(1990, 12, 21), Height = 5.6M, Weight = 56, Grade = 10 },
                    new Student { StudentName = "Charle", DateOfBirth = new DateTime(1993, 12, 11), Height = 5.5M, Weight = 56, Grade = 7 }
                };

                // Add students to database
                client.Students.AddRange(students);
                client.SaveChanges();

                // Add students info to HTML content
                foreach (var student in students)
                {
                    content = AddStudent(content, student);
                }
            }

            content += "<h2>Display Students in Database</h2>";

            // Display Students in Database
            using (var client = new DatabaseContext())
            {
                Console.WriteLine($"Displaying Students in Database:");
                var students = client.Students.ToList();

                foreach (var student in students)
                {
                    Console.WriteLine($"Name= {student.StudentName}, ID={student.StudentID}, Grade={student.Grade}, Weight={student.Weight}, Height={student.Height}");
                    content = AddStudent(content, student);
                }
            }           

            // Render HTML content to PDF
            var pdf = renderer.RenderHtmlAsPdf(content);

            // Export to a file or stream
            pdf.SaveAs("AwesomeEfCoreAndIronPdf.pdf");
        }

        // Helper method to add student info as HTML content
        private static string AddStudent(string content, Student student)
        {
            content += $"<p Name = {student.StudentName}, ID={student.StudentID}, Grade={student.Grade}, Weight={student.Weight}, Height={student.Height}</p>";
            return content;
        }
    }

    public class DatabaseContext : DbContext
    {
        public DbSet<Student> Students { get; set; }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            optionsBuilder.UseSqlite("Filename=IronPdfDemo.db");
        }        
    }

    public class Student
    {
        public int StudentID { get; set; }
        public string StudentName { get; set; }
        public DateTime? DateOfBirth { get; set; }
        public decimal Height { get; set; }
        public float Weight { get; set; }
        public int Grade { get; set; }
    }
}

using IronPdf;
using Microsoft.EntityFrameworkCore;
using System;
using System.Linq;

namespace CodeSample
{
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("-------------Demo EF core and IronPDF--------------");

            // Disable local disk access or cross-origin requests
            Installation.EnableWebSecurity = true;

            // Instantiate Renderer
            var renderer = new ChromePdfRenderer();

            // Start with initial HTML content
            var content = "<h1>Demo EF core and IronPDF</h1>";
            content += "<h2>Add Students</h2>";

            // Add Students to Database
            using (var client = new DatabaseContext())
            {
                client.Database.EnsureCreated(); // Create table if it doesn't exist
                client.Students.ExecuteDelete(); // Ensure the table is clean

                // Define students
                var students = new[]
                {
                    new Student { StudentName = "Bill", DateOfBirth = new DateTime(1990, 12, 01), Height = 5.45M, Weight = 56, Grade = 10 },
                    new Student { StudentName = "Mike", DateOfBirth = new DateTime(1992, 12, 06), Height = 4.45M, Weight = 34, Grade = 8 },
                    new Student { StudentName = "Peter", DateOfBirth = new DateTime(1990, 12, 03), Height = 5.0M, Weight = 50, Grade = 10 },
                    new Student { StudentName = "Bob", DateOfBirth = new DateTime(1990, 12, 09), Height = 4.56M, Weight = 56, Grade = 10 },
                    new Student { StudentName = "Harry", DateOfBirth = new DateTime(1990, 12, 21), Height = 5.6M, Weight = 56, Grade = 10 },
                    new Student { StudentName = "Charle", DateOfBirth = new DateTime(1993, 12, 11), Height = 5.5M, Weight = 56, Grade = 7 }
                };

                // Add students to database
                client.Students.AddRange(students);
                client.SaveChanges();

                // Add students info to HTML content
                foreach (var student in students)
                {
                    content = AddStudent(content, student);
                }
            }

            content += "<h2>Display Students in Database</h2>";

            // Display Students in Database
            using (var client = new DatabaseContext())
            {
                Console.WriteLine($"Displaying Students in Database:");
                var students = client.Students.ToList();

                foreach (var student in students)
                {
                    Console.WriteLine($"Name= {student.StudentName}, ID={student.StudentID}, Grade={student.Grade}, Weight={student.Weight}, Height={student.Height}");
                    content = AddStudent(content, student);
                }
            }           

            // Render HTML content to PDF
            var pdf = renderer.RenderHtmlAsPdf(content);

            // Export to a file or stream
            pdf.SaveAs("AwesomeEfCoreAndIronPdf.pdf");
        }

        // Helper method to add student info as HTML content
        private static string AddStudent(string content, Student student)
        {
            content += $"<p Name = {student.StudentName}, ID={student.StudentID}, Grade={student.Grade}, Weight={student.Weight}, Height={student.Height}</p>";
            return content;
        }
    }

    public class DatabaseContext : DbContext
    {
        public DbSet<Student> Students { get; set; }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            optionsBuilder.UseSqlite("Filename=IronPdfDemo.db");
        }        
    }

    public class Student
    {
        public int StudentID { get; set; }
        public string StudentName { get; set; }
        public DateTime? DateOfBirth { get; set; }
        public decimal Height { get; set; }
        public float Weight { get; set; }
        public int Grade { get; set; }
    }
}

Imports IronPdf
Imports Microsoft.EntityFrameworkCore
Imports System
Imports System.Linq

Namespace CodeSample
    Public Class Program
        Public Shared Sub Main()
            Console.WriteLine("-------------Demo EF core and IronPDF--------------")

            ' Disable local disk access or cross-origin requests
            Installation.EnableWebSecurity = True

            ' Instantiate Renderer
            Dim renderer = New ChromePdfRenderer()

            ' Start with initial HTML content
            Dim content = "<h1>Demo EF core and IronPDF</h1>"
            content += "<h2>Add Students</h2>"

            ' Add Students to Database
            Using client = New DatabaseContext()
                client.Database.EnsureCreated() ' Create table if it doesn't exist
                client.Students.ExecuteDelete() ' Ensure the table is clean

                ' Define students
                Dim students = {
                    New Student With {.StudentName = "Bill", .DateOfBirth = New DateTime(1990, 12, 1), .Height = 5.45D, .Weight = 56, .Grade = 10},
                    New Student With {.StudentName = "Mike", .DateOfBirth = New DateTime(1992, 12, 6), .Height = 4.45D, .Weight = 34, .Grade = 8},
                    New Student With {.StudentName = "Peter", .DateOfBirth = New DateTime(1990, 12, 3), .Height = 5.0D, .Weight = 50, .Grade = 10},
                    New Student With {.StudentName = "Bob", .DateOfBirth = New DateTime(1990, 12, 9), .Height = 4.56D, .Weight = 56, .Grade = 10},
                    New Student With {.StudentName = "Harry", .DateOfBirth = New DateTime(1990, 12, 21), .Height = 5.6D, .Weight = 56, .Grade = 10},
                    New Student With {.StudentName = "Charle", .DateOfBirth = New DateTime(1993, 12, 11), .Height = 5.5D, .Weight = 56, .Grade = 7}
                }

                ' Add students to database
                client.Students.AddRange(students)
                client.SaveChanges()

                ' Add students info to HTML content
                For Each student In students
                    content = AddStudent(content, student)
                Next
            End Using

            content += "<h2>Display Students in Database</h2>"

            ' Display Students in Database
            Using client = New DatabaseContext()
                Console.WriteLine("Displaying Students in Database:")
                Dim students = client.Students.ToList()

                For Each student In students
                    Console.WriteLine($"Name= {student.StudentName}, ID={student.StudentID}, Grade={student.Grade}, Weight={student.Weight}, Height={student.Height}")
                    content = AddStudent(content, student)
                Next
            End Using

            ' Render HTML content to PDF
            Dim pdf = renderer.RenderHtmlAsPdf(content)

            ' Export to a file or stream
            pdf.SaveAs("AwesomeEfCoreAndIronPdf.pdf")
        End Sub

        ' Helper method to add student info as HTML content
        Private Shared Function AddStudent(content As String, student As Student) As String
            content += $"<p Name = {student.StudentName}, ID={student.StudentID}, Grade={student.Grade}, Weight={student.Weight}, Height={student.Height}</p>"
            Return content
        End Function
    End Class

    Public Class DatabaseContext
        Inherits DbContext

        Public Property Students As DbSet(Of Student)

        Protected Overrides Sub OnConfiguring(optionsBuilder As DbContextOptionsBuilder)
            optionsBuilder.UseSqlite("Filename=IronPdfDemo.db")
        End Sub
    End Class

    Public Class Student
        Public Property StudentID As Integer
        Public Property StudentName As String
        Public Property DateOfBirth As DateTime?
        Public Property Height As Decimal
        Public Property Weight As Single
        Public Property Grade As Integer
    End Class
End Namespace

Çıktı

IronPDF Lisanslama

IronPDF paketi, PDF oluşturmak ve çalıştırmak için bir lisans gerektirir. Aşağıdaki kodu uygulamanın başlangıcında pakete erişmeden önce ekleyin.

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY";

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY";

Imports IronPdf

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY"

Deneme lisansı, IronPDF Lisanslama Sayfası'ndan alınabilir.

Sonuç

C#'daki Entity Framework Core, LINQ desteği, veritabanı geçişleri ve işlem yönetimi gibi özellikler sunarak veritabanlarıyla etkileşim kurmanın sağlam ve sezgisel bir yolunu sağlar. En iyi uygulamaları izleyerek ve güçlü yeteneklerinden yararlanarak, geliştiriciler ölçeklenebilir ve sürdürülebilir uygulamaları kolaylıkla geliştirebilirler. İster deneyimli bir geliştirici olun ister yeni başlayın, EF Core modern veri erişimi için C# uygulamalarında sahip olunması gereken değerli bir araçtır. Öte yandan, IronPDF uygulamalarınız içinde PDF belgeleri oluşturmak, manipüle etmek ve işlemek için bir .NET kütüphanesidir. HTML içeriğini (görüntüler dahil) PDF dosyasına dönüştürmek için EF Core ile birlikte kullanabilirsiniz.