Bölüm 5, ASP.NET Core MVC uygulamasındaki bir veritabanıyla çalışma

Rick Anderson ve Jon P Smith tarafından.

Giriş

Öğretici serisinin bu bölümü, ASP.NET Core MVC uygulamanızda bir SQL veritabanıyla çalışmaya odaklanır.

Şunları nasıl yapacağınızı öğreneceksiniz:

• ASP.NET Core MVC uygulamanız için Entity Framework Core veritabanı bağlamını kaydedin ve yapılandırın.
• Yerel geliştirme için veritabanı bağlantı dizeleriyle çalışma.
• Geliştirme için SQL Server Express LocalDB kullanın ve SQL Server Nesne Gezgini'ni kullanarak veritabanınızı ve verilerinizi inceleyin.
• Veritabanınızı ilk örnek verilerle tohumlar.

Önkoşul

Bu öğreticide önceki adımda ayarladığınız bir veritabanı kullanılır: Bölüm 4, ASP.NET Core MVC uygulamasına model ekleme.

Veritabanı bağlamıyla çalışma

MvcMovieContext nesnesi, veritabanına bağlanma ve nesneleri veritabanı kayıtlarına eşleme Movie görevini işler. Veritabanı bağlamı, Bağımlılık Enjeksiyonu kapsayıcısına Program.cs dosyasında kaydedilir.

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.")));

ASP.NET Core Yapılandırma sistemi ConnectionString anahtarını okur. Yerel geliştirme için appsettings.json dosyasından bağlantı dizesini alır.

"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")));

ASP.NET Core Yapılandırma sistemi ConnectionString'i okur. Yerel geliştirme için appsettings.json dosyasından bağlantı dizesini alır.

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

Uyarı

Bu makalede, kullanıcının kimliğinin doğrulanması gerekmeyen bir yerel veritabanı kullanılır. Üretim uygulamaları kullanılabilir en güvenli kimlik doğrulama akışını kullanmalıdır. Dağıtılan test ve üretim uygulamaları için kimlik doğrulaması hakkında daha fazla bilgi için bkz . Güvenli kimlik doğrulama akışları.

Visual Studio

SQL Server Express LocalDB (Yerel Veritabanı Motoru)

LocalDB:

• Varsayılan olarak Visual Studio ile yüklenen SQL Server Express Veritabanı Altyapısı'nın basit bir sürümüdür.
• bir bağlantı dizesi kullanarak isteğe bağlı olarak başlar.
• Program geliştirme için amaçlanmıştır. Kullanıcı modunda çalıştığından karmaşık bir yapılandırma yoktur.
• Varsayılan olarak C:/Users/{user} dizininde .mdf dosyaları oluşturur.

Veritabanını inceleme

Görünüm menüsünden SQL Server Nesne Gezgini (SSOX) öğesini açın.

Tabloya Movie sağ tıklayın (dbo.Movie) > Görünüm Tasarımcısı

ID öğesinin yanındaki anahtar simgesine dikkat edin. Varsayılan olarak, EF birincil anahtar adlı ID bir özellik yapar.

Verileri Görüntüle tablosuna Movie> sağ tıklayın

Visual Studio Code

SQLite

SQLite web sitesi aşağıdakileri belirtir:

SQLite, bağımsız, yüksek güvenilirlikli, tümleşik, tam özellikli, genel etki alanı, SQL veritabanı altyapısıdır. SQLite, dünyada en çok kullanılan veritabanı altyapısıdır.

SQLite veritabanını yönetmek ve görüntülemek için indirebileceğiniz birçok üçüncü taraf aracı vardır. Aşağıdaki görüntü SQLite için DB Tarayıcısı'ndan alınmıştı. Sık kullanılan bir SQLite aracınız varsa, bu araç hakkında neleri beğendiğinize ilişkin bir yorum bırakın.

Not

Bu eğitim için mümkün olduğunca Entity Framework Core geçişleri özelliğini kullanırsınız. Geçişler veritabanı şemasını veri modelindeki değişikliklerle eşleşecek şekilde güncelleştirir. Ancak geçişler yalnızca sağlayıcının EF Core desteklediği türde değişiklikler yapabilir ve SQLite sağlayıcısının özellikleri sınırlıdır. Örneğin, sütun ekleme desteklenir, ancak sütunu kaldırma veya değiştirme desteklenmez. Bir sütunu kaldırmak veya değiştirmek için bir geçiş oluşturulursa, ef migrations add komut başarılı olur ancak ef database update komut başarısız olur. Bu sınırlamalar nedeniyle bu öğretici, SQLite şema değişiklikleri için geçişleri kullanmaz. Bunun yerine, şema değiştiğinde veritabanını bırakır ve yeniden oluşturursunuz.

SQLite sınırlamaları için geçici çözüm, tablodaki bir şey değiştiğinde tablo yeniden derlemesi gerçekleştirmek için geçiş kodunu el ile yazmaktır. Tablo yeniden oluşturma şunları içerir:

• Yeni tablo oluşturma.
• Eski tablodan yeni tabloya veri kopyalama.
• Eski masayı bırak.
• Yeni tabloyu yeniden adlandırma.

Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:

• SQLite EF Core Veritabanı Sağlayıcısı Sınırlamaları
• Geçiş kodunu özelleştirme
• Veri ekleme
• SQLite ALTER TABLE deyimi

Veritabanının tohumunu oluşturma

Models klasöründe adlı SeedDatayeni bir sınıf oluşturun. Oluşturulan kodu aşağıdakilerle değiştirin:

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();
        }
    }
}

Veri tabanında herhangi bir film varsa, başlangıç düzenleyicisi işlevini tamamlar ve hiçbir film eklenmeyecek.

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

Tohum başlatıcıyı ekle

Visual Studio

öğesinin içeriğini Program.cs aşağıdaki kodla değiştirin. Yeni kod vurgulanır.

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();

Veritabanındaki tüm kayıtları silin. Bunu tarayıcıdaki veya SSOX'taki silme bağlantılarıyla yapabilirsiniz.

Uygulamayı test etme. Uygulamayı başlatmaya zorlayın ve Program.cs dosyasındaki kodu çağırarak seed yönteminin çalışmasını sağlayın. Başlatmayı zorlamak için Visual Studio'da açılan komut istemi penceresini kapatın ve Ctrl+F5 tuşlarına basarak yeniden başlatın.

Visual Studio Code

Aşağıdaki vurgulanmış kodla güncelleştirin Program.cs :

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();

Veritabanındaki tüm kayıtları silin.

Uygulamayı test etme. Durdurun ve yeniden başlatın, böylece SeedData.Initialize yöntemi çalışır ve veritabanını başlangıç verileriyle doldurur.

Uygulama, dağıtılmış verileri gösterir.

Önceki: Modelekleme Sonraki: Denetleyici yöntemleri ve görünümleri ekleme