Поделиться через

Начало работы с EF Core

В этом руководстве вы создадите консольное приложение .NET Core, которое выполняет доступ к данным в базе данных SQLite с помощью Entity Framework Core.

Руководство можно выполнить с помощью Visual Studio в Windows или с помощью .NET CLI в Windows, macOS или Linux.

Просмотрите пример этой статьи на сайте GitHub.

Предпосылки

Установите следующее программное обеспечение:

Создание нового проекта

dotnet new console -o EFGetStarted
cd EFGetStarted

Установка Entity Framework Core

Чтобы установить EF Core, необходимо установить пакет для поставщиков баз данных EF Core, которые вы хотите нацелить. В этом руководстве используется SQLite, так как он выполняется на всех платформах, поддерживаемых .NET. Список доступных поставщиков см. в разделе "Поставщики баз данных".

dotnet add package Microsoft.EntityFrameworkCore.Sqlite

Создание модели

Определите класс контекста и классы сущностей, составляющие модель.

  • В каталоге проекта создайте Model.cs со следующим кодом.
using Microsoft.EntityFrameworkCore;
using System;
using System.Collections.Generic;

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

    public string DbPath { get; }

    public BloggingContext()
    {
        var folder = Environment.SpecialFolder.LocalApplicationData;
        var path = Environment.GetFolderPath(folder);
        DbPath = System.IO.Path.Join(path, "blogging.db");
    }

    // The following configures EF to create a Sqlite database file in the
    // special "local" folder for your platform.
    protected override void OnConfiguring(DbContextOptionsBuilder options)
        => options.UseSqlite($"Data Source={DbPath}");
}

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }

    public List<Post> Posts { get; } = new();
}

public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }

    public int BlogId { get; set; }
    public Blog Blog { get; set; }
}

EF Core также может перепроектировать модель из существующей базы данных.

Совет. Это приложение намеренно держит вещи простыми для ясности. Строки подключения не должны храниться в коде для рабочих приложений. Вы также можете разделить каждый класс C# на собственный файл.

Создание базы данных

Шаги, описанные ниже, используют миграции для создания базы данных.

  • Выполните следующие команды:

    dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet ef migrations add InitialCreate
dotnet ef database update

    При этом устанавливается dotnet ef и пакет конструктора, необходимый для выполнения команды в проекте. Команда migrations создает шаблон миграции для создания начального набора таблиц для модели. Команда database update создает базу данных и применяет к ней новую миграцию.

Создание, чтение, обновление & удаления

  • Откройте Program.cs и замените содержимое следующим кодом:

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

using var db = new BloggingContext();

// Note: This sample requires the database to be created before running.
Console.WriteLine($"Database path: {db.DbPath}.");

// Create
Console.WriteLine("Inserting a new blog");
db.Add(new Blog { Url = "http://blogs.msdn.com/adonet" });
await db.SaveChangesAsync();

// Read
Console.WriteLine("Querying for a blog");
var blog = await db.Blogs
    .OrderBy(b => b.BlogId)
    .FirstAsync();

// Update
Console.WriteLine("Updating the blog and adding a post");
blog.Url = "https://devblogs.microsoft.com/dotnet";
blog.Posts.Add(
    new Post { Title = "Hello World", Content = "I wrote an app using EF Core!" });
await db.SaveChangesAsync();

// Delete
Console.WriteLine("Delete the blog");
db.Remove(blog);
await db.SaveChangesAsync();

Запуск приложения

dotnet run

Дальнейшие шаги