Entity Framework Core (Jak to dziala dla programistow)

Zrozumienie Entity Framework Core

Entity Framework Core to otwarta, lekka i rozszerzalna wersja popularnej technologii dostępu do danych Entity Framework. Zostało zaprojektowane do pracy na wielu platformach, obsługując różnych dostawców serwerów baz danych, w tym SQL Server, SQLite, MySQL, PostgreSQL, Azure Cosmos DB i inne. EF Core to nowoczesny mapper obiektowo-relacyjny, działający zgodnie z wzorcem ORM (Object-Relational Mapping), umożliwiający programistom pracę z bazami danych przy użyciu obiektów .NET, co eliminuje konieczność ręcznego pisania żmudnych zapytań SQL.

Kluczowe funkcje EF Core

1. Modelowanie encji: EF Core umożliwia programistom definiowanie modeli danych przy użyciu obiektów POCO (Plain Old CLR Objects). Te klasy encji reprezentują tabele bazy danych, a ich właściwości odpowiadają kolumnom tabel.

2. Obsługa LINQ: EF Core płynnie obsługuje zapytania LINQ (Language Integrated Query), umożliwiając programistom pisanie silnie typowanych zapytań do serwera SQL lub dowolnej innej bazy danych przy użyciu znanej składni C#. Dzięki temu wyszukiwanie danych jest intuicyjne i zmniejsza się prawdopodobieństwo wystąpienia błędów w czasie wykonywania. Ponadto można używać surowych instrukcji SQL wraz z zapytaniami LINQ.

3. Migracje baz danych: Zarządzanie zmianami schematu bazy danych może stanowić wyzwanie, zwłaszcza w środowisku zespołowym. EF Core upraszcza ten proces, zapewniając możliwości migracji baz danych, co pozwala programistom na wprowadzanie stopniowych zmian w schemacie bazy danych przy użyciu migracji typu "code-first".

4. Ładowanie leniwe i ładowanie natychmiastowe: EF Core obsługuje zarówno strategię ładowania leniwego, jak i natychmiastowego, umożliwiając programistom optymalizację wydajności poprzez ładowanie powiązanych danych na żądanie lub z wyprzedzeniem, w zależności od przypadku użycia.

5. Zarządzanie transakcjami: Transakcje zapewniają spójność i integralność danych podczas operacji na bazie danych. EF Core pozwala programistom na wyraźną obsługę transakcji, gwarantując, że grupa operacji na bazie danych zakończy się sukcesem lub niepowodzeniem jako całość.

6. Kontrola współbieżności: EF Core zapewnia wbudowaną obsługę zarządzania konfliktami współbieżności, umożliwiając programistom wykrywanie i rozwiązywanie konfliktów, które mogą powstać, gdy wielu użytkowników próbuje jednocześnie modyfikować te same dane.

Pierwsze kroki z EF Core

Stwórzmy prosty przykład użycia SQLite z Entity Framework Core (EF Core) w aplikacji ASP.NET Core. Oto kolejne kroki:

1. Utwórz swoją aplikację:

   • Zacznij od utworzenia aplikacji konsolowej lub ASP.NET.

2. Zainstaluj niezbędne pakiety:

   • Dodaj do swojego projektu następujące pakiety NuGet:

     • Microsoft.EntityFrameworkCore (wersja 1.0.0 lub nowsza)
     • Microsoft.EntityFrameworkCore.Sqlite (wersja 1.0.0 lub nowsza)

3. Stwórz kontekst bazy danych:

   • Zdefiniuj klasę dla kontekstu bazy danych (np. DatabaseContext), która dziedziczy po DbContext.

   • W metodzie OnConfiguring ustaw ciąg połączenia SQLite:

     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. Zarejestruj kontekst:

   • W klasie Startup dodaj swój kontekst do usług:

     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. Utwórz bazę danych podczas uruchamiania:

   • W konstruktorze Startup utwórz swoją bazę danych:

     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. Wykorzystaj SQLite w swojej aplikacji:

   • Teraz możesz używać SQLite w swojej aplikacji ASP.NET Core za pośrednictwem EF Core.
   • Zdefiniuj swoje modele i użyj DatabaseContext do interakcji z bazą danych.

Należy pamiętać, że jest to podstawowy przykład i istnieją inne sposoby konfiguracji ciągu połączenia oraz korzystania z EF Core. Zapraszamy do zapoznania się z bardziej zaawansowanymi funkcjami i dostosowania ich do konkretnych potrzeb!

Najlepsze praktyki dotyczące programowania w EF Core

1. Ogranicz zakres DbContext: Instancje DbContext w EF Core są zaprojektowane tak, aby miały krótki czas życia i zazwyczaj powinny być ograniczone do czasu trwania pojedynczego żądania w aplikacjach internetowych.

2. Użyj AsNoTracking do operacji tylko do odczytu: Podczas wykonywania operacji tylko do odczytu, w których nie przewiduje się modyfikacji encji, użyj metody AsNoTracking, aby poprawić wydajność poprzez pominięcie śledzenia zmian.

3. Optymalizacja zapytań: Twórz wydajne zapytania, stosując odpowiednie techniki indeksowania, paginacji i filtrowania, aby zminimalizować ilość danych pobieranych z bazy danych.

4. Unikaj problemów związanych z zapytaniami N+1: Pamiętaj o problemie zapytań N+1, w którym zapytanie jest wykonywane dla każdego powiązanego elementu w zbiorze. Użyj ładowania z wyprzedzeniem (eager loading) lub ładowania jawnego (explicit loading), aby efektywnie pobierać powiązane dane.

5. Monitorowanie wydajności: Monitoruj wydajność EF Core za pomocą narzędzi takich jak Entity Framework Profiler lub wbudowanych funkcji logowania, aby zidentyfikować i wyeliminować wąskie gardła wydajności.

Wprowadzenie do IronPDF

IronPDF to potężna biblioteka C# do obsługi plików PDF, która pozwala generować, edytować i wyodrębniać treści z dokumentów PDF w projektach .NET. Oto kilka kluczowych funkcji:

1. Konwersja HTML do PDF:

   • Konwersja treści HTML, CSS i JavaScript do formatu PDF.
   • Użyj silnika renderującego Chrome, aby uzyskać pliki PDF o idealnej rozdzielczości.
   • Generuj pliki PDF z adresów URL, plików HTML lub ciągów znaków HTML.

2. Konwersja obrazów i treści:

   • Konwertuj obrazy do i z formatu PDF.
   • Wyodrębnianie tekstu i obrazów z istniejących plików PDF.
   • Obsługa różnych formatów obrazów.

3. Edycja i obróbka:

   • Ustawianie właściwości, zabezpieczeń i uprawnień dla plików PDF.
   • Dodaj podpisy cyfrowe.
   • Edytuj metadane i historię zmian.

4. Obsługa wielu platform:

   • Działa z .NET Core (8, 7, 6, 5 i 3.1+), .NET Standard (2.0+) oraz .NET Framework (4.6.2+).
   • Kompatybilny z systemami Windows, Linux i macOS.
   • Dostępne w serwisie NuGet, co ułatwia instalację.

Generowanie dokumentu PDF przy użyciu IronPDF wraz z EF Core

Na początek utwórz aplikację konsolową za pomocą programu Visual Studio, jak pokazano poniżej.

Podaj nazwę projektu.

Zapewnij wersję .NET na różne platformy.

Zainstaluj pakiet Microsoft.EntityFrameworkCore.

Zainstaluj pakiet Microsoft.EntityFrameworkCore.SqlLite.

Zainstaluj pakiet IronPDF.

Dodaj poniższy kod do Program.cs.

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

Wynik

Licencjonowanie IronPDF

Pakiet IronPDF wymaga licencji do uruchomienia i generowania plików PDF. Dodaj poniższy kod na początku aplikacji, zanim nastąpi dostęp do pakietu.

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

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

Imports IronPdf

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

Licencja Trial jest dostępna na stronie licencyjnej IronPDF.

Wnioski

Entity Framework Core w języku C# zapewnia solidny i intuicyjny sposób interakcji z bazami danych, oferując gotowe do użycia funkcje, takie jak obsługa LINQ, migracje baz danych i zarządzanie transakcjami. Stosując się do najlepszych praktyk i wykorzystując jego potężne możliwości, programiści mogą z łatwością tworzyć skalowalne i łatwe w utrzymaniu aplikacje. Niezależnie od tego, czy jesteś doświadczonym programistą, czy dopiero zaczynasz, EF Core jest cennym narzędziem, które warto mieć w swoim zestawie narzędzi do nowoczesnego dostępu do danych w aplikacjach C#. Z drugiej strony, IronPDF to biblioteka .NET służąca do tworzenia, edycji i renderowania dokumentów PDF w ramach aplikacji. Można go używać razem z EF Core do konwersji treści HTML (w tym obrazów) do pliku PDF.