Entity Framework Core (Como funciona para desenvolvedores)

Entendendo o Entity Framework Core

O Entity Framework Core é uma versão de código aberto, leve e extensível da popular tecnologia de acesso a dados Entity Framework. Ele foi projetado para funcionar em diversas plataformas, oferecendo suporte a vários provedores de servidores de banco de dados existentes, incluindo SQL Server, SQLite, MySQL, PostgreSQL, Azure Cosmos DB e outros. O EF Core é um mapeador de banco de dados orientado a objetos moderno que segue o padrão ORM (Mapeamento Objeto-Relacional), permitindo que os desenvolvedores trabalhem com bancos de dados usando objetos .NET , o que elimina a necessidade de escrever manualmente consultas SQL tediosas.

Principais características do EF Core

1. Modelagem de Entidades: O EF Core permite que os desenvolvedores definam modelos de dados usando objetos CLR simples (POCOs). Essas classes de entidade representam tabelas de banco de dados, com propriedades mapeadas para colunas da tabela.

2. Suporte a LINQ: O EF Core oferece suporte integrado a consultas LINQ (Language Integrated Query), permitindo que os desenvolvedores escrevam consultas fortemente tipadas no SQL Server ou em qualquer outro banco de dados usando a sintaxe familiar do C#. Isso torna a consulta de dados intuitiva e reduz a probabilidade de erros em tempo de execução. Além disso, instruções SQL brutas podem ser usadas juntamente com consultas LINQ.

3. Migrações de banco de dados: Gerenciar alterações no esquema do banco de dados pode ser um desafio, especialmente em um ambiente de equipe. O EF Core simplifica esse processo ao fornecer recursos de migração de banco de dados, permitindo que os desenvolvedores apliquem alterações incrementais ao esquema do banco de dados usando migrações "code-first".

4. Carregamento lento (lazy loading) e carregamento antecipado (eager loading): O EF Core suporta estratégias de carregamento lento e carregamento antecipado, permitindo que os desenvolvedores otimizem o desempenho carregando os dados relevantes sob demanda ou antecipadamente, dependendo do caso de uso.

5. Gerenciamento de transações: As transações garantem a consistência e a integridade dos dados durante as operações do banco de dados. O EF Core permite que os desenvolvedores trabalhem explicitamente com transações, garantindo que um grupo de operações de banco de dados seja bem-sucedido ou falhe em conjunto.

6. Controle de Concorrência: O EF Core oferece suporte integrado para o gerenciamento de conflitos de concorrência, permitindo que os desenvolvedores detectem e resolvam conflitos que podem surgir quando vários usuários tentam modificar os mesmos dados simultaneamente.

Primeiros passos com o EF Core

Vamos criar um exemplo básico de como usar o SQLite com o Entity Framework Core (EF Core) em uma aplicação ASP.NET Core . Eis os passos:

1. Crie sua candidatura:

   • Comece criando um aplicativo de console ou ASP.NET .

2. Instale os pacotes necessários:

   • Adicione os seguintes pacotes NuGet ao seu projeto:

     • Microsoft.EntityFrameworkCore (versão 1.0.0 ou posterior)
     • Microsoft.EntityFrameworkCore.Sqlite (versão 1.0.0 ou posterior)

3. Crie o contexto do seu banco de dados:

   • Defina uma classe para o seu contexto de banco de dados (por exemplo, DatabaseContext) que herde de DbContext.

   • No método OnConfiguring, defina a string de conexão do 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. Registre o contexto:

   • Na sua classe Startup, adicione o contexto aos serviços:

     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. Criar o banco de dados na inicialização:

   • No construtor Startup, crie seu banco de dados:

     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. Utilize o SQLite em sua aplicação:

   Agora você pode usar o SQLite em sua aplicação ASP.NET Core através do EF Core.

   • Defina seus modelos e use o DatabaseContext para interagir com o banco de dados.

Lembre-se de que este é um exemplo básico e que existem outras maneiras de configurar a string de conexão e usar o EF Core. Sinta-se à vontade para explorar recursos mais avançados e adaptá-los às suas necessidades específicas!

Melhores práticas para o desenvolvimento do EF Core

1. Mantenha o escopo do DbContext definido: as instâncias de DbContext no EF Core são projetadas para serem de curta duração e normalmente devem ter seu escopo limitado ao tempo de vida de uma única solicitação em aplicações web.

2. Use AsNoTracking para operações somente leitura: Ao executar operações somente leitura em que não se espera que as entidades sejam modificadas, use o método AsNoTracking para melhorar o desempenho, ignorando o rastreamento de alterações.

3. Otimizar consultas: Escreva consultas eficientes utilizando técnicas apropriadas de indexação, paginação e filtragem para minimizar a quantidade de dados recuperados do banco de dados.

4. Evite problemas de consulta N+1: Esteja atento ao problema de consulta N+1, em que uma consulta é executada para cada entidade relacionada em uma coleção. Utilize o carregamento antecipado ou o carregamento explícito para buscar dados relacionados de forma eficiente.

5. Monitorar o desempenho: Monitore o desempenho do EF Core usando ferramentas como o Entity Framework Profiler ou os recursos de registro integrados para identificar e solucionar gargalos de desempenho.

Introdução ao IronPDF

IronPDF é uma poderosa biblioteca C# para PDF que permite gerar, editar e extrair conteúdo de documentos PDF em projetos .NET . Aqui estão algumas características principais:

1. Conversão de HTML para PDF:

   • Converter conteúdo HTML, CSS e JavaScript para o formato PDF.
   • Utilize o mecanismo de renderização do Chrome para PDFs com qualidade de imagem perfeita.
   • Gere PDFs a partir de URLs, arquivos HTML ou strings HTML.

2. Conversão de imagem e conteúdo:

   • Converter imagens de e para PDF.
   • Extrair texto e imagens de PDFs existentes.
   • Suporte para diversos formatos de imagem.

3. Edição e Manipulação:

   • Defina propriedades, segurança e permissões para PDFs.
   • Adicionar assinaturas digitais.
   • Editar metadados e histórico de revisões.

4. Suporte multiplataforma:

   • Funciona com .NET Core (8, 7, 6, 5 e 3.1+), .NET Standard (2.0+) e .NET Framework (4.6.2+).
   • Compatível com Windows, Linux e macOS.
   • Disponível no NuGet para fácil instalação.

Gere documentos PDF usando o IronPDF juntamente com o EF Core.

Para começar, crie um aplicativo de console usando o Visual Studio, conforme mostrado abaixo.

Informe o nome do projeto.

Disponibilize uma versão multiplataforma do .NET .

Instale o pacote Microsoft.EntityFrameworkCore.

Instale o pacote Microsoft.EntityFrameworkCore.SqlLite.

Instale o pacote IronPDF .

Adicione o código abaixo a 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

Saída

Licenciamento IronPDF

O pacote IronPDF requer uma licença para ser executado e gerar o PDF. Adicione o código abaixo no início da aplicação, antes que o pacote seja acessado.

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

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

Imports IronPdf

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

Uma licença de avaliação está disponível na página de licenciamento do IronPDF .

Conclusão

O Entity Framework Core em C# oferece uma maneira robusta e intuitiva de interagir com bancos de dados, disponibilizando recursos como suporte a LINQ, migrações de banco de dados e gerenciamento de transações prontos para uso. Seguindo as melhores práticas e aproveitando seus poderosos recursos, os desenvolvedores podem criar aplicativos escaláveis ​​e de fácil manutenção com facilidade. Seja você um desenvolvedor experiente ou esteja apenas começando, o EF Core é uma ferramenta valiosa para se ter em seu conjunto de ferramentas para acesso a dados modernos em aplicativos C#. Por outro lado, o IronPDF é uma biblioteca .NET para criar, manipular e renderizar documentos PDF dentro de seus aplicativos. Você pode usá-lo juntamente com o EF Core para converter conteúdo HTML (incluindo imagens) em um arquivo PDF.