Bagian 4 dari seri tutorial di Razor Pages

Oleh Joe Audette

Objek RazorPagesMovieContext menangani tugas menyambungkan ke database dan memetakan Movie objek ke rekaman database. Konteks database terdaftar dengan kontainer Injeksi Dependensi di Program.cs:

Visual Studio

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

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

Visual Studio Code / Visual Studio untuk Mac

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

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

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

Visual Studio

string koneksi yang dihasilkan mirip dengan JSON berikut:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext-bc;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Visual Studio Code / Visual Studio untuk Mac

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Data Source=RazorPagesMovie.Data.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 mesin database SQL Server Express yang ditargetkan untuk pengembangan program. LocalDB dimulai sesuai permintaan dan berjalan dalam mode pengguna, sehingga tidak ada konfigurasi yang kompleks. Secara default, database LocalDB membuat *.mdf file di C:\Users\<user>\ direktori.

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

   

2. Klik kanan pada Movie tabel dan pilih Tampilkan Perancang:

   

   

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

3. Klik kanan pada Movie tabel dan pilih Tampilkan Data:

   

Visual Studio Code / Visual Studio untuk Mac

SQLite

Situs web SQLite menyatakan:

SQLite adalah mesin database SQL yang mandiri, memiliki keandalan tinggi, tertanam, berfokus penuh, domain publik, dan SQL. 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, fitur migrasi Entity Framework Core digunakan jika memungkinkan. Migrasi memperbarui skema database agar sesuai dengan perubahan dalam model data. Namun, migrasi hanya dapat melakukan jenis perubahan yang EF Core didukung penyedia, 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, database dihilangkan dan dibuat ulang.

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
• Seeding data
• Pernyataan SQLite ALTER TABLE

Seed database

Buat kelas baru bernama SeedData di folder Model dengan kode berikut:

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;

namespace RazorPagesMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new RazorPagesMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<RazorPagesMovieContext>>()))
        {
            if (context == null || context.Movie == null)
            {
                throw new ArgumentNullException("Null RazorPagesMovieContext");
            }

            // 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 benih akan kembali dan tidak ada film yang ditambahkan.

if (context.Movie.Any())
{
    return;
}

Menambahkan penginisialisasi benih

Program.cs Perbarui dengan kode yang disorot berikut:

Visual Studio

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;
using RazorPagesMovie.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

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

    SeedData.Initialize(services);
}

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Visual Studio Code / Visual Studio untuk Mac

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;
using RazorPagesMovie.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

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

    SeedData.Initialize(services);
}

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Dalam kode sebelumnya, Program.cs telah dimodifikasi untuk melakukan hal berikut:

• Dapatkan instans konteks database dari kontainer injeksi dependensi (DI).
• seedData.Initialize Panggil metode , teruskan ke dalamnya instans konteks database.
• Buang konteks ketika metode benih selesai. Pernyataan penggunaan memastikan konteks dibuang.

Pengecualian berikut terjadi ketika Update-Database belum dijalankan:

SqlException: Cannot open database "RazorPagesMovieContext-" requested by the login. The login failed. Login failed for user 'user name'.

Menguji aplikasi

Hapus semua rekaman dalam database sehingga metode seed akan berjalan. Hentikan dan mulai aplikasi untuk menyemai database. Jika database tidak diunggulkan, letakkan titik henti if (context.Movie.Any()) dan telusuri kode.

Aplikasi ini menunjukkan data seeded:

Langkah berikutnya

Sebelumnya: HalamanPerancah Razor Berikutnya: Perbarui halaman