Partie 4 de la série de tutoriels sur Pages Razor

Par Joe Audette

L’objet RazorPagesMovieContext gère la tâche de connexion à la base de données et de mappage d’objets Movie à des enregistrements de la base de données. Enregistrez le contexte de la base de données dans le conteneur d’injection de dépendances dans 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.")));

Visual Studio Code

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.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

Le système de configuration d’ASP.NET Core lit la clé ConnectionString. Pour le développement local, la configuration obtient la chaîne de connexion à partir du fichier appsettings.json.

Visual Studio

La chaîne de connexion générée est similaire au JSON suivant :

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext-f2e0482c-952d-4b1c-afe9-a1a3dfe52e55;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Visual Studio Code

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Data Source=RazorPagesMovie.Data.db"
  }
}

Warning

Cet article utilise une base de données locale qui ne nécessite pas l’authentification des utilisateurs. Les applications de production doivent utiliser le flux d’authentification le plus sécurisé disponible. Pour plus d’informations sur l’authentification pour les applications de test et de production déployées, consultez Flux d’authentification sécurisés.

Visual Studio

SQL Server Express LocalDB

LocalDB est une version légère du moteur de base de données SQL Server Express conçu pour le développement de programmes. LocalDB démarre à la demande et s’exécute en mode utilisateur, ce qui n’implique aucune configuration complexe. Par défaut, LocalDB crée des *.mdf fichiers de base de données dans le C:\Users\<user>\ répertoire.

1. Dans le menu Affichage, ouvrez l’Explorateur d’objets SQL Server (SSOX).

   

2. Faites un clic droit sur la table Movie et sélectionnez Concepteur de vues :

   

   

   Notez l’icône de clé en regard de ID. Par défaut, EF crée une propriété nommée ID pour la clé primaire.

3. Faites un clic droit sur la table Movie et sélectionnez Afficher les données :

   

Visual Studio Code

SQLite

Le site web SQLite indique :

SQLite est un moteur SQL Database autonome, à haute fiabilité, incorporé, complet, public-domain. SQLite est le moteur de base de données le plus utilisé au monde.

Vous pouvez télécharger de nombreux outils tiers pour gérer et afficher une base de données SQLite. L’image suivante provient de DB Browser pour SQLite. Si vous avez un outil SQLite préféré, laissez un commentaire pour nous dire ce que vous aimez chez lui.

Note

Pour ce tutoriel, utilisez la fonctionnalité de migration Entity Framework Core dans la cas où cela est possible. Les migrations mettent à jour le schéma de la base de données afin qu’il reflète les changements apportés au modèle de données. Toutefois, les migrations peuvent uniquement apporter des modifications prises en charge par le EF Core fournisseur et les fonctionnalités du fournisseur SQLite sont limitées. Par exemple, l’ajout d’une colonne est pris en charge, mais la suppression ou la modification d’une colonne n’est pas prise en charge. Si vous créez une migration pour supprimer ou modifier une colonne, la ef migrations add commande réussit, mais la ef database update commande échoue. En raison de ces limitations, ce tutoriel n’utilise pas les migrations pour les modifications de schéma SQLite. Au lieu de cela, lorsque le schéma change, la base de données est supprimée et recréée.

Pour remédier aux limitations de SQLite, vous devez écrire le code de migrations manuellement pour regénérer le tableau lorsqu’un élément est modifié. La regénération d’un tableau implique :

• Création d’une nouvelle table.
• Copie des données de l’ancienne table vers la nouvelle table.
• Suppression de l’ancienne table.
• Renommer la nouvelle table.

Pour plus d’informations, consultez les ressources suivantes :

• Limites d’un fournisseur de base de données EF Core SQLite
• Personnaliser le code de migration
• Amorçage des données
• Instruction SQL ALTER TABLE de SQLite

Peupler la base de données

Créez une classe nommée SeedData dans le dossier Modèles avec le code suivant :

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

Si la base de données contient des films, l’initialiseur initiale retourne et n’ajoute aucun film.

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

Ajouter l’initialiseur de seed

Mettez à jour Program.cs avec le code mis en évidence suivant :

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

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

Visual Studio Code

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

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();

app.Run();

Dans le code précédent, vous modifiez Program.cs pour effectuer les étapes suivantes :

• Créez une étendue de service avec app.Services.CreateScope().
• Obtenez le fournisseur de services (IServiceProvider) à partir de la portée.
• Appelez la méthode SeedData.Initialize en lui transmettant le fournisseur de services.
• Libérez la portée du service une fois que la méthode d’initialisation est terminée. L’instructionusing garantit que la portée est libérée.

L’exception suivante se produit lorsque vous n’exécutez Update-Databasepas :

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

Testez l’application

Supprimez tous les enregistrements de la base de données afin que la méthode d'ensemencement s’exécute. Arrêtez et démarrez l’application pour initialiser la base de données. Si la base de données n’est pas initialisée, placez un point d’arrêt sur if (context.Movie.Any()) et parcourez le code.

L’application affiche les données de départ :

Étapes suivantes

Précédent : Pages Razor générées par scaffoldingSuivant : Mettre à jour les pages