Parte 5. Trabajo con una base de datos en una aplicación de ASP.NET Core MVC

Por Rick Anderson y Jon P Smith.

El objeto MvcMovieContext controla la tarea de conexión a la base de datos y asignación de objetos Movie a los registros de la base de datos. El contexto de base de datos se registra con el contenedor de inserción de dependencias en el archivo 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.")));

El sistema Configuración de ASP.NET Core lee la clave ConnectionString. Para el desarrollo local, obtiene la cadena de conexión del archivo appsettings.json :

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

El sistema Configuración de ASP.NET Core lee el elemento ConnectionString. Para el desarrollo local, obtiene la cadena de conexión del archivo appsettings.json :

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

Advertencia

En este artículo se usa una base de datos local que no requiere que el usuario se autentique. Las aplicaciones de producción deben usar el flujo de autenticación más seguro disponible. Para obtener más información sobre la autenticación para aplicaciones de prueba y producción implementadas, consulta Flujos de autenticación seguros.

Visual Studio

SQL Server Express LocalDB

LocalDB:

• Es una versión ligera del motor de base de datos de SQL Server Express, instalada de forma predeterminada con Visual Studio.
• Se inicia a petición mediante una cadena de conexión.
• Está destinado al desarrollo de programas. Se ejecuta en modo de usuario, sin necesidad de una configuración compleja.
• De forma predeterminada, crea archivos .mdf en el directorio C:/Usuarios/{user} .

Examen de la base de datos

En el menú Ver, abra Explorador de objetos de SQL Server (SSOX).

Haga clic con el botón derecho en la tabla Movie (dbo.Movie) > Diseñador de vistas

Observe el icono de llave junto a ID. De forma predeterminada, EF convierte una propiedad denominada ID en la clave principal.

Haga clic con el botón derecho en la tabla MovieMovie.

Visual Studio Code

SQLite

Según la información del sitio web de SQLite:

SQLite es un motor de base de datos SQL independiente, de alta confiabilidad, insertado, con características completas y dominio público. SQLite es el motor de base de datos más usado en el mundo.

Existen muchas herramientas de terceros que se pueden descargar para administrar y ver una base de datos de SQLite. La imagen de abajo es de DB Browser for SQLite. Si tiene una herramienta favorita de SQLite, deje un comentario sobre lo que le gusta de ella.

Nota

Para este tutorial usará la característica de las migraciones de Entity Framework Core siempre que sea posible. Las migraciones actualizan el esquema de la base de datos para que coincida con los cambios en el modelo de datos. Aun así, las migraciones solo pueden realizar los tipos de cambios que admite el proveedor de EF Core; las funcionalidades del proveedor de SQLite son limitadas. Por ejemplo, se permite agregar una columna, pero no eliminarla ni cambiarla. Si se crea una migración para quitar o cambiar una columna, el comando ef migrations add se ejecuta correctamente, pero el comando ef database update produce un error. Debido a estas limitaciones, este tutorial no usa las migraciones para realizar cambios en el esquema de SQLite. En su lugar, cuando cambie el esquema, desconectará la base de datos y volverá a crearla.

La solución alternativa para las limitaciones de SQLite consiste en escribir de forma manual el código de migraciones para llevar a cabo una recompilación de la tabla cuando cambie algún elemento de esta. La recompilación de una tabla implica lo siguiente:

• Crear una tabla.
• Copiar datos de la tabla antigua a la nueva tabla.
• Eliminar la tabla anterior.
• Cambiar el nombre de la tabla nueva.

Para obtener más información, vea los siguientes recursos:

• Limitaciones del proveedor de base de datos SQLite de EF Core
• Personalización del código de migración
• Propagación de los datos
• Instrucción ALTER TABLE de SQLite

Inicializar la base de datos

Cree una nueva clase denominada SeedData en la carpeta SeedData. Reemplace el código generado con el siguiente:

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

Si hay alguna película en la base de datos, se devuelve el inicializador y no se agrega ninguna película.

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

Agregar el inicializador

Visual Studio

Reemplace el contenido de Program.cs por el código siguiente. El nuevo código está resaltado.

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

Elimine todos los registros de la base de datos. Puede hacerlo con los vínculos de eliminación en el explorador o desde SSOX.

Probar la aplicación. Obligue a la aplicación a inicializarse; para ello, llame al código en el archivo Program.cs para que se ejecute el método de inicialización. Para forzar la inicialización, cierre la ventana del símbolo del sistema que Visual Studio abrió y reinicie presionando Ctrl+F5.

Visual Studio Code

Actualice Program.cs con el siguiente código resaltado:

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

Elimine todos los registros de la base de datos.

Probar la aplicación. Deténgala y reiníciela para que el método SeedData.Initialize ejecute e inicialice la base de datos.

La aplicación muestra los datos inicializados.

Anterior: Adición de un modeloSiguiente: Adición de vistas y métodos de controlador