Bagian 5, bekerja dengan database di aplikasi MVC Inti ASP.NET

Oleh Rick Anderson dan Jon P Smith.

Pendahuluan

Bagian seri tutorial ini berfokus pada bekerja dengan database SQL di aplikasi MVC Core ASP.NET Anda.

Anda akan mempelajari cara:

• Daftarkan dan konfigurasikan konteks database Entity Framework Core untuk aplikasi MVC Core ASP.NET Anda.
• Bekerja dengan string koneksi database untuk pengembangan lokal.
• Gunakan SQL Server Express LocalDB untuk pengembangan dan memeriksa database dan data Anda menggunakan SQL Server Object Explorer.
• Isi database Anda dengan data contoh awal.

Prasyarat

Tutorial ini menggunakan database yang Anda siapkan di langkah sebelumnya: Bagian 4, tambahkan model ke aplikasi MVC Inti ASP.NET.

Bekerja dengan konteks database

Objek MvcMovieContext menangani tugas menyambungkan ke database dan memetakan Movie objek ke rekaman database. Konteks database didaftarkan dengan kontainer Dependency Injection dalam file Program.cs.

Visual Studio

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

Sistem Konfigurasi Inti ASP.NET membaca ConnectionString kunci. Untuk pengembangan lokal, ia mendapatkan string koneksi dari appsettings.json file:

"ConnectionStrings": {
  "MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-4ebefa10-de29-4dea-b2ad-8a8dc6bcf374;Trusted_Connection=True;MultipleActiveResultSets=true"
}

Visual Studio Code

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

Sistem Konfigurasi Inti ASP.NET membaca ConnectionString. Untuk pengembangan lokal, ia mendapatkan string koneksi dari appsettings.json file:

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovie.db"
}

Peringatan

Artikel ini menggunakan database lokal yang tidak mengharuskan pengguna untuk diautentikasi. Aplikasi produksi harus menggunakan alur autentikasi paling aman yang tersedia. Untuk informasi selengkapnya tentang autentikasi untuk aplikasi pengujian dan produksi yang disebarkan, lihat Mengamankan alur autentikasi.

Visual Studio

LocalDB SQL Server Express

LocalDB:

• Adalah versi ringan dari SQL Server Express Database Engine, yang diinstal secara default dengan Visual Studio.
• Mulai sesuai permintaan dengan menggunakan string koneksi.
• Ditargetkan untuk pengembangan program. Ini berjalan dalam mode pengguna, sehingga tidak ada konfigurasi yang kompleks.
• Secara default membuat file .mdf di direktori C:/Users/{user} .

Memeriksa database

Dari menu Tampilan, buka SQL Server Object Explorer (SSOX).

Klik kanan pada Movie tabel (dbo.Movie) > View Designer

Perhatikan ikon kunci di samping ID. Secara default, EF membuat properti bernama ID kunci utama.

Klik kanan pada Movie tabel > Tampilkan Data

>

Visual Studio Code

SQLite

Situs web SQLite menyatakan:

SQLite adalah mesin database SQL yang mandiri, berkeandalan tinggi, terintegrasi, berfitur lengkap, dan domain publik. SQLite adalah mesin database yang paling banyak digunakan di dunia.

Ada banyak alat pihak ketiga yang dapat Anda unduh untuk mengelola dan melihat database SQLite. Gambar di bawah ini berasal dari Browser DB untuk SQLite. Jika Anda memiliki alat SQLite favorit, tinggalkan komentar tentang apa yang Anda suka tentang hal itu.

Catatan

Untuk tutorial ini, Anda menggunakan fitur migrasi Entity Framework Core jika memungkinkan. Migrasi memperbarui skema database agar sesuai dengan perubahan dalam model data. Namun, migrasi hanya dapat melakukan jenis perubahan yang didukung oleh penyedia EF Core, dan kemampuan penyedia SQLite terbatas. Misalnya, menambahkan kolom didukung, tetapi menghapus atau mengubah kolom tidak didukung. Jika migrasi dibuat untuk menghapus atau mengubah kolom, ef migrations add perintah berhasil tetapi ef database update perintah gagal. Karena keterbatasan ini, tutorial ini tidak menggunakan migrasi untuk perubahan skema SQLite. Sebagai gantinya, ketika skema berubah, Anda menghilangkan dan membuat ulang database.

Solusi untuk batasan SQLite adalah menulis kode migrasi secara manual untuk melakukan pembangunan ulang tabel saat sesuatu dalam tabel berubah. Pembangunan ulang tabel melibatkan:

• Membuat tabel baru.
• Menyalin data dari tabel lama ke tabel baru.
• Menjatuhkan tabel lama.
• Mengganti nama tabel baru.

Untuk informasi selengkapnya, lihat sumber daya berikut:

• Batasan Penyedia Database SQLite EF Core
• Menyesuaikan kode migrasi
• Pembenihan data
• Pernyataan SQLite ALTER TABLE

Isi basis data

Buat kelas baru bernama SeedData di folder Model . Ganti kode yang dihasilkan dengan yang berikut ini:

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using System;
using System.Linq;

namespace MvcMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new MvcMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<MvcMovieContext>>()))
        {
            // Look for any movies.
            if (context.Movie.Any())
            {
                return;   // DB has been seeded
            }
            context.Movie.AddRange(
                new Movie
                {
                    Title = "When Harry Met Sally",
                    ReleaseDate = DateTime.Parse("1989-2-12"),
                    Genre = "Romantic Comedy",
                    Price = 7.99M
                },
                new Movie
                {
                    Title = "Ghostbusters ",
                    ReleaseDate = DateTime.Parse("1984-3-13"),
                    Genre = "Comedy",
                    Price = 8.99M
                },
                new Movie
                {
                    Title = "Ghostbusters 2",
                    ReleaseDate = DateTime.Parse("1986-2-23"),
                    Genre = "Comedy",
                    Price = 9.99M
                },
                new Movie
                {
                    Title = "Rio Bravo",
                    ReleaseDate = DateTime.Parse("1959-4-15"),
                    Genre = "Western",
                    Price = 3.99M
                }
            );
            context.SaveChanges();
        }
    }
}

Jika ada film dalam database, penginisialisasi awal akan menghentikan proses dan tidak ada film yang ditambahkan.

if (context.Movie.Any())
{
    return;  // DB has been seeded.
}

Menambahkan penginisialisasi benih

Visual Studio

Ganti isi Program.cs dengan kode berikut. Kode baru disorot.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Hapus semua rekaman dalam database. Anda dapat melakukan ini dengan tautan penghapusan di browser atau dari SSOX.

Menguji aplikasi. Paksa aplikasi untuk mulai diinisialisasi, memanggil kode dalam file Program.cs, sehingga metode seed berjalan. Untuk memaksa inisialisasi, tutup jendela prompt perintah yang dibuka Visual Studio, dan mulai ulang dengan menekan Ctrl+F5.

Visual Studio Code

Perbarui Program.cs dengan kode yang disorot berikut:

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Hapus semua rekaman dalam database.

Menguji aplikasi. Hentikan dan mulai ulang lagi sehingga metode SeedData.Initialize berjalan dan mengisi database.

Aplikasi ini menunjukkan data seeded.

Sebelumnya: Menambahkan modelBerikutnya: Menambahkan metode dan tampilan pengontrol