Partie 2, ajouter un modèle à une application de pages Razor dans ASP.NET Core

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet RazorPagesMovie>Ajouter>Nouveau dossier. Nommez le dossier Models.

2. Cliquez avec le bouton droit sur le dossier Models. Sélectionnez Ajouter>Classe. Nommez la classe Movie.

3. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• Attribut [DataType] qui spécifie le type de données dans la propriété ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

• La présence du point d’interrogation après string indique que la propriété peut accepter les valeurs Null. Pour plus d’informations, consultez Types référence pouvant accepter la valeur Null.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Générez le projet pour vérifier qu’il n’y a pas d’erreur de compilation.

1. Ajoutez un dossier nommé Models.
2. Ajoutez une classe au dossier Models nommé Movie.cs.

Ajoutez les propriétés suivantes à la classe Movie :

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

• La présence du point d’interrogation après string indique que la propriété peut accepter les valeurs Null. Pour plus d’informations, consultez Types référence pouvant accepter la valeur Null.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Ajouter des packages NuGet des outils EF

Exécutez les commandes CLI .NET suivantes :

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design --prerelease
dotnet add package Microsoft.EntityFrameworkCore.SQLite --prerelease
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --prerelease
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --prerelease
dotnet add package Microsoft.EntityFrameworkCore.Tools --prerelease

Les commandes précédentes ajoutent :

• Outils de l’interface de ligne de commande (CLI) pour EF Core
• Outil de génération de modèles automatique aspnet-codegenerator.
• Outils de temps de conception pour EF Core
• Le fournisseur EF Core SQLite, qui installe le package EF Core comme une dépendance.
• Les packages nécessaires à la génération de modèles automatique : Microsoft.VisualStudio.Web.CodeGeneration.Design et Microsoft.EntityFrameworkCore.SqlServer.

Pour obtenir de l’aide sur la configuration de plusieurs environnements qui permet à une application de configurer ses contextes de base de données par environnement, consultez Utiliser plusieurs environnements dans ASP.NET Core.

Dans Visual Studio Code, appuyez sur Ctrl+F5 (Windows) ou ⌘+F5 (macOS) pour exécuter l’application sans débogage.

Dans le panneau situé sous la région de l’éditeur, sélectionnez l’onglet PROBLÈMES ou, dans le menu Affichage, sélectionnez Problèmes s’il n’est pas actuellement affiché. Vérifiez qu’il n’y a pas d’erreur de compilation.

1. Créez le dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

2. Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvel élément généré automatiquement.

   

3. Dans la boîte de dialogue Ajouter un nouveau modèle automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

4. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la liste déroulante Classe de modèle, sélectionnez Film (RazorPagesMovie.Models).
   2. Dans la ligne Classe du contexte de données, sélectionnez le signe + (plus).
      1. Dans la boîte de dialogue Ajouter un contexte de données, le nom de la classe RazorPagesMovie.Data.RazorPagesMovieContext est généré.
      2. Dans la liste déroulante Fournisseur de base de données, sélectionnez SQL Server.
   3. Sélectionnez Ajouter.

   

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

• Ouvrez un interpréteur de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj. Exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Le tableau suivant détaille les paramètres du générateur de code ASP.NET Core.

Utilisez l’option -h pour obtenir de l’aide sur la commande dotnet aspnet-codegenerator razorpage :

dotnet aspnet-codegenerator razorpage -h

Pour plus d’informations, consultez dotnet aspnet-codegenerator.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Dans cette section, la fenêtre Console du gestionnaire de package est utilisée pour :

• Ajouter une migration initiale

• Mettez à jour la base de données avec la migration initiale.

• Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Console du gestionnaire de package.

  

• Dans la console PMC, entrez la commande suivante :

  Add-Migration InitialCreate
  

• La commande Add-Migration génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer la migration. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

L’avertissement suivant s’affiche et sera traité dans une étape ultérieure :

Aucun type n’a été spécifié pour la colonne décimale 'Price' sur le type d’entité 'Movie'. Les valeurs sont tronquées en mode silencieux si elles ne sont pas compatibles avec la précision et l’échelle par défaut. Spécifiez explicitement le type de colonne SQL Server capable d’accueillir toutes les valeurs en utilisant ’HasColumnType()’.

• Dans la console PMC, entrez la commande suivante :

  Update-Database
  

  La commande Update-Database exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

• Cliquez avec le bouton droit sur le projet RazorPagesMovie.csproj, puis sélectionnez Ouvrir dans le terminal intégré.

  La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

• Exécutez la commande CLI .NET suivante :

  dotnet ef migrations add InitialCreate
  

  La commande migrations génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer les migrations. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

• Exécutez la commande CLI .NET suivante :

  dotnet ef database update
  

  La commande update exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande update exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet RazorPagesMovie>Ajouter>Nouveau dossier. Nommez le dossier Models.

2. Cliquez avec le bouton droit sur le dossier Models. Sélectionnez Ajouter>Classe. Nommez la classe Movie.

3. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• Attribut [DataType] qui spécifie le type de données dans la propriété ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

• La présence du point d’interrogation après string indique que la propriété peut accepter les valeurs Null. Pour plus d’informations, consultez Types référence pouvant accepter la valeur Null.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Générez le projet pour vérifier qu’il n’y a pas d’erreur de compilation.

1. Ajoutez un dossier nommé Models.
2. Ajoutez une classe au dossier Models nommé Movie.cs.

Ajoutez les propriétés suivantes à la classe Movie :

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

• La présence du point d’interrogation après string indique que la propriété peut accepter les valeurs Null. Pour plus d’informations, consultez Types référence pouvant accepter la valeur Null.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Ajouter des packages NuGet des outils EF

Exécutez les commandes CLI .NET suivantes :

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

Les commandes précédentes ajoutent :

• Outils de l’interface de ligne de commande (CLI) pour EF Core
• Outil de génération de modèles automatique aspnet-codegenerator.
• Outils de temps de conception pour EF Core
• Le fournisseur EF Core SQLite, qui installe le package EF Core comme une dépendance.
• Les packages nécessaires à la génération de modèles automatique : Microsoft.VisualStudio.Web.CodeGeneration.Design et Microsoft.EntityFrameworkCore.SqlServer.

Pour obtenir de l’aide sur la configuration de plusieurs environnements qui permet à une application de configurer ses contextes de base de données par environnement, consultez Utiliser plusieurs environnements dans ASP.NET Core.

Dans Visual Studio Code, appuyez sur Ctrl+F5 (Windows) ou ⌘+F5 (macOS) pour exécuter l’application sans débogage.

Dans le panneau situé sous la région de l’éditeur, sélectionnez l’onglet PROBLÈMES ou, dans le menu Affichage, sélectionnez Problèmes s’il n’est pas actuellement affiché. Vérifiez qu’il n’y a pas d’erreur de compilation.

1. Dans la fenêtre Outil solution, cliquez sur le projet RazorPagesMovie, puis sélectionnez Ajouter>Nouveau dossier.... Nommez le dossier Models.

2. Cliquez sur le dossier Models, puis sélectionnez Ajouter une>nouvelle classe....

3. Dans la boîte de dialogue Nouveau fichier :

   1. Dans le volet gauche, sélectionnez Général.
   2. Dans le volet central, sélectionnez Classe vide.
   3. Nommez la classe Movie, puis sélectionnez Créer.

4. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Générez le projet pour vérifier qu’il n’y a pas d’erreur de compilation.

1. Créez le dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

2. Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvel élément généré automatiquement.

   

3. Dans la boîte de dialogue Ajouter un nouveau modèle automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

4. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la liste déroulante Classe de modèle, sélectionnez Film (RazorPagesMovie.Models).
   2. Dans la ligne Classe du contexte de données, sélectionnez le signe + (plus).
      1. Dans la boîte de dialogue Ajouter un contexte de données, le nom de la classe RazorPagesMovie.Data.RazorPagesMovieContext est généré.
      2. Dans la liste déroulante Fournisseur de base de données, sélectionnez SQL Server.
   3. Sélectionnez Ajouter.

   

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

• Ouvrez un interpréteur de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj. Exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Le tableau suivant détaille les paramètres du générateur de code ASP.NET Core.

Utilisez l’option -h pour obtenir de l’aide sur la commande dotnet aspnet-codegenerator razorpage :

dotnet aspnet-codegenerator razorpage -h

Pour plus d’informations, consultez dotnet aspnet-codegenerator.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

1. Ajoutez le package NuGet Microsoft.EntityFrameworkCore.Sqlite, qui est requis pour l’outil de génération de modèles automatique.

   1. Dans la fenêtre Outil solution, cliquez sur le projet RazorPagesMovie, puis sélectionnez Ouvrir dans le terminal.

   La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

   1. Exécutez la commande CLI .NET suivante :

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Créer un dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

3. Cliquez sur le dossier Pages/Movies >Ajouter>Nouvelle génération de modèles automatique....

   

4. Dans la boîte de dialogue Nouvelle génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

5. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la ligne classe de modèle à utiliser :, entrez Movie.
   2. Dans la ligne classe DbContext à utiliser :, nommez la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Sélectionnez Terminer.

   

Le processus de génération de modèles automatique peut prendre un certain temps, car les packages requis sont automatiquement téléchargés et ajoutés au projet.

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Dans cette section, la fenêtre Console du gestionnaire de package est utilisée pour :

• Ajouter une migration initiale

• Mettez à jour la base de données avec la migration initiale.

• Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Console du gestionnaire de package.

  

• Dans la console PMC, entrez la commande suivante :

  Add-Migration InitialCreate
  

• La commande Add-Migration génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer la migration. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

L’avertissement suivant s’affiche et sera traité dans une étape ultérieure :

Aucun type n’a été spécifié pour la colonne décimale 'Price' sur le type d’entité 'Movie'. Les valeurs sont tronquées en mode silencieux si elles ne sont pas compatibles avec la précision et l’échelle par défaut. Spécifiez explicitement le type de colonne SQL Server capable d’accueillir toutes les valeurs en utilisant ’HasColumnType()’.

• Dans la console PMC, entrez la commande suivante :

  Update-Database
  

  La commande Update-Database exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

• Cliquez avec le bouton droit sur le projet RazorPagesMovie.csproj, puis sélectionnez Ouvrir dans le terminal intégré.

  La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

• Exécutez la commande CLI .NET suivante :

  dotnet ef migrations add InitialCreate
  

  La commande migrations génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer les migrations. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

• Exécutez la commande CLI .NET suivante :

  dotnet ef database update
  

La commande update exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande update exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

• Cliquez sur le projet RazorPagesMovie, puis sélectionnez Ouvrir dans le terminal.

  La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

• Exécutez les commandes CLI .NET Core suivantes :

  dotnet tool uninstall --global dotnet-ef
  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• Les commandes tool installent les derniers outils Entity Framework Core après avoir désinstallé la version précédente, le cas échéant.

  Remarque

  Par défaut, l’architecture des fichiers binaires .NET à installer représente l’architecture du système d’exploitation en cours d’exécution. Pour spécifier une architecture de système d’exploitation différente, consultez dotnet tool install, --arch option. Pour plus d'informations, consultez le problème GitHub dotnet/AspNetCore.Docs n° 29262.

• La commande migrations génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer les migrations. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

• La commande update exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande update exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

L’avertissement suivant s’affiche et sera traité dans une étape ultérieure :

Aucun type n’a été spécifié pour la colonne décimale 'Price' sur le type d’entité 'Movie'. Les valeurs sont tronquées en mode silencieux si elles ne sont pas compatibles avec la précision et l’échelle par défaut. Spécifiez explicitement le type de colonne SQL Server capable d’accueillir toutes les valeurs en utilisant ’HasColumnType()’.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet RazorPagesMovie>Ajouter>Nouveau dossier. Nommez le dossier Models.

2. Cliquez avec le bouton droit sur le dossier Models. Sélectionnez Ajouter>Classe. Nommez la classe Movie.

3. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• Attribut [DataType] qui spécifie le type de données dans la propriété ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

• La présence du point d’interrogation après string indique que la propriété peut accepter les valeurs Null. Pour plus d’informations, consultez Types référence pouvant accepter la valeur Null.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Générez le projet pour vérifier qu’il n’y a pas d’erreur de compilation.

1. Ajoutez un dossier nommé Models.
2. Ajoutez une classe au dossier Models nommé Movie.cs.

Ajoutez les propriétés suivantes à la classe Movie :

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

• La présence du point d’interrogation après string indique que la propriété peut accepter les valeurs Null. Pour plus d’informations, consultez Types référence pouvant accepter la valeur Null.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Ajouter des packages NuGet des outils EF

Exécutez les commandes CLI .NET suivantes :

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

Les commandes précédentes ajoutent :

• Outils de l’interface de ligne de commande (CLI) pour EF Core
• Outil de génération de modèles automatique aspnet-codegenerator.
• Outils de temps de conception pour EF Core
• Le fournisseur EF Core SQLite, qui installe le package EF Core comme une dépendance.
• Les packages nécessaires à la génération de modèles automatique : Microsoft.VisualStudio.Web.CodeGeneration.Design et Microsoft.EntityFrameworkCore.SqlServer.

Pour obtenir de l’aide sur la configuration de plusieurs environnements qui permet à une application de configurer ses contextes de base de données par environnement, consultez Utiliser plusieurs environnements dans ASP.NET Core.

Dans Visual Studio Code, appuyez sur Ctrl+F5 (Windows) ou ⌘+F5 (macOS) pour exécuter l’application sans débogage.

Dans le panneau situé sous la région de l’éditeur, sélectionnez l’onglet PROBLÈMES ou, dans le menu Affichage, sélectionnez Problèmes s’il n’est pas actuellement affiché. Vérifiez qu’il n’y a pas d’erreur de compilation.

1. Dans la fenêtre Outil solution, cliquez sur le projet RazorPagesMovie, puis sélectionnez Ajouter>Nouveau dossier.... Nommez le dossier Models.

2. Cliquez sur le dossier Models, puis sélectionnez Ajouter une>nouvelle classe....

3. Dans la boîte de dialogue Nouveau fichier :

   1. Dans le volet gauche, sélectionnez Général.
   2. Dans le volet central, sélectionnez Classe vide.
   3. Nommez la classe Movie, puis sélectionnez Créer.

4. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Générez le projet pour vérifier qu’il n’y a pas d’erreur de compilation.

1. Créez le dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

2. Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvel élément généré automatiquement.

   

3. Dans la boîte de dialogue Ajouter un nouveau modèle automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

4. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la liste déroulante Classe de modèle, sélectionnez Film (RazorPagesMovie.Models).
   2. Dans la ligne Classe du contexte de données, sélectionnez le signe + (plus).
      1. Dans la boîte de dialogue Ajouter un contexte de données, le nom de la classe RazorPagesMovie.Data.RazorPagesMovieContext est généré.
      2. Dans la liste déroulante Fournisseur de base de données, sélectionnez SQL Server.
   3. Sélectionnez Ajouter.

   

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

• Ouvrez un interpréteur de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj. Exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Le tableau suivant détaille les paramètres du générateur de code ASP.NET Core.

Utilisez l’option -h pour obtenir de l’aide sur la commande dotnet aspnet-codegenerator razorpage :

dotnet aspnet-codegenerator razorpage -h

Pour plus d’informations, consultez dotnet aspnet-codegenerator.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

1. Ajoutez le package NuGet Microsoft.EntityFrameworkCore.Sqlite, qui est requis pour l’outil de génération de modèles automatique.

   1. Dans la fenêtre Outil solution, cliquez sur le projet RazorPagesMovie, puis sélectionnez Ouvrir dans le terminal.

   La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

   1. Exécutez la commande CLI .NET suivante :

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Créer un dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

3. Cliquez sur le dossier Pages/Movies >Ajouter>Nouvelle génération de modèles automatique....

   

4. Dans la boîte de dialogue Nouvelle génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

5. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la ligne classe de modèle à utiliser :, entrez Movie.
   2. Dans la ligne classe DbContext à utiliser :, nommez la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Sélectionnez Terminer.

   

Le processus de génération de modèles automatique peut prendre un certain temps, car les packages requis sont automatiquement téléchargés et ajoutés au projet.

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Dans cette section, la fenêtre Console du gestionnaire de package est utilisée pour :

• Ajouter une migration initiale
• Mettez à jour la base de données avec la migration initiale.

1. Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Console du gestionnaire de package.

   

2. Dans la console du Gestionnaire de package, entrez les commandes suivantes :

   Add-Migration InitialCreate
   Update-Database
   

• La commande Add-Migration génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer la migration. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

• La commande Update-Database exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

• Cliquez avec le bouton droit sur le projet RazorPagesMovie.csproj, puis sélectionnez Ouvrir dans le terminal intégré.

  La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

• Exécutez les commandes CLI .NET suivantes :

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• La commande migrations génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer les migrations. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

• La commande update exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande update exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

• Cliquez sur le projet RazorPagesMovie, puis sélectionnez Ouvrir dans le terminal.

  La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

• Exécutez les commandes CLI .NET Core suivantes :

  dotnet tool uninstall --global dotnet-ef
  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• Les commandes tool installent les derniers outils Entity Framework Core après avoir désinstallé la version précédente, le cas échéant.

  Remarque

  Par défaut, l’architecture des fichiers binaires .NET à installer représente l’architecture du système d’exploitation en cours d’exécution. Pour spécifier une architecture de système d’exploitation différente, consultez dotnet tool install, --arch option. Pour plus d'informations, consultez le problème GitHub dotnet/AspNetCore.Docs n° 29262.

• La commande migrations génère le code nécessaire à la création du schéma de base de données initial. Le schéma est basé sur le modèle spécifié dans DbContext. L’argument InitialCreate est utilisé pour nommer les migrations. Vous pouvez utiliser n’importe quel nom, mais par convention, un nom décrivant la migration est sélectionné.

• La commande update exécute la méthode Up dans des migrations qui n’ont pas été appliquées. Dans ce cas, la commande update exécute la méthode Up dans le fichier Migrations/<time-stamp>_InitialCreate.cs, ce qui entraîne la création de la base de données.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet RazorPagesMovie>Ajouter>Nouveau dossier. Nommez le dossier Models.

2. Cliquez avec le bouton droit sur le dossier Models. Sélectionnez Ajouter>Classe. Nommez la classe Movie.

3. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; } = string.Empty;
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; } = string.Empty;
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• Attribut [DataType] qui spécifie le type de données dans la propriété ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

1. Ajoutez un dossier nommé Models.
2. Ajoutez une classe au dossier Models nommé Movie.cs.

Ajoutez les propriétés suivantes à la classe Movie :

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; } = string.Empty;

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; } = string.Empty;
        public decimal Price { get; set; }
    }
}

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Ajouter des packages NuGet des outils EF

Exécutez les commandes CLI .NET suivantes :

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer

Les commandes précédentes ajoutent :

• Outils de l’interface de ligne de commande (CLI) pour EF Core
• Outil de génération de modèles automatique aspnet-codegenerator.
• Outils de temps de conception pour EF Core
• Le fournisseur EF Core SQLite, qui installe le package EF Core comme une dépendance.
• Les packages nécessaires à la génération de modèles automatique : Microsoft.VisualStudio.Web.CodeGeneration.Design et Microsoft.EntityFrameworkCore.SqlServer.

Pour obtenir de l’aide sur la configuration de plusieurs environnements qui permet à une application de configurer ses contextes de base de données par environnement, consultez Utiliser plusieurs environnements dans ASP.NET Core.

1. Dans la fenêtre Outil solution, cliquez avec le bouton droit sur le projet RazorPagesMovie, puis sélectionnez Ajouter>Nouveau dossier.... Nommez le dossier Models.

2. Cliquez avec le bouton droit sur le dossier Models, puis sélectionnez Ajouter>Nouveau fichier.

3. Dans la boîte de dialogue Nouveau fichier :

   1. Dans le volet gauche, sélectionnez Général.
   2. Dans le volet central, sélectionnez Classe vide.
   3. Nommez la classe Movie, puis sélectionnez Créer.

4. Ajoutez les propriétés suivantes à la classe Movie :

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; } = string.Empty;
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; } = string.Empty;
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contient :

• Champ ID permettant de fournir une clé primaire pour la base de données.

• Attribut [DataType] pour spécifier le type de données dans le champ ReleaseDate. Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

1. Ajoutez le package NuGet Microsoft.EntityFrameworkCore.Design, qui est requis pour l’outil de génération de modèles automatique.

   1. Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Gérer les packages NuGet pour la solution.
   2. Sélectionnez l’onglet Parcourir.
   3. Saisissez Microsoft.EntityFrameworkCore.Design, et sélectionnez-le dans la liste.
   4. Cochez Projet, puis sélectionnez Installer
   5. Sélectionnez J’accepte dans la boîte de dialogue Acceptation de licence.

2. Créez le dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

3. Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvel élément généré automatiquement.

   

4. Dans la boîte de dialogue Ajouter un nouveau modèle automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

5. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la liste déroulante Classe de modèle, sélectionnez Film (RazorPagesMovie.Models).
   2. Dans la ligne Classe du contexte de données, sélectionnez le signe + (plus).
      1. Dans la boîte de dialogue Ajouter un contexte de données, le nom de la classe RazorPagesMovie.Data.RazorPagesMovieContext est généré.
   3. Sélectionnez Ajouter.

   

   Si vous recevez un message d’erreur indiquant que vous devez installer le package Microsoft.EntityFrameworkCore.SqlServer, répétez les étapes commençant par Ajouter>Nouvel élément généré automatiquement.

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

• Ouvrez un interpréteur de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj. Exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries -sqlite
  

Le tableau suivant détaille les paramètres du générateur de code ASP.NET Core.

Utilisez l’option -h pour obtenir de l’aide sur la commande dotnet aspnet-codegenerator razorpage :

dotnet aspnet-codegenerator razorpage -h

Pour plus d’informations, consultez dotnet aspnet-codegenerator.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

1. Créer un dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

2. Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvelle génération de modèles automatique....

   

3. Dans la boîte de dialogue Nouvelle génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

4. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la ligne classe de modèle à utiliser :, entrez Movie.
   2. Dans la ligne classe DbContext à utiliser :, nommez la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Sélectionnez Terminer.

   

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment sélectionner la chaîne de connexion SQLite dans le développement et SQL Server dans la production.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Le code précédent n’appelle pas UseDeveloperExceptionPage dans le développement, car WebApplication appelle UseDeveloperExceptionPage en mode développement.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Dans cette section, la fenêtre Console du gestionnaire de package est utilisée pour :

• Ajouter une migration initiale
• Mettez à jour la base de données avec la migration initiale.

1. Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Console du gestionnaire de package.

   

2. Dans la console du Gestionnaire de package, entrez les commandes suivantes :

   Add-Migration InitialCreate
   Update-Database
   
   

• Dans la fenêtre Outil solution, cliquez avec le bouton droit sur le projet RazorPagesMovie, puis sélectionnez Ouvrir dans le terminal.

  La fenêtre Terminal s’ouvre avec l’invite de commandes dans le répertoire du projet, qui contient les fichiers Program.cs et .csproj.

• Exécutez les commandes CLI .NET suivantes :

  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

  Remarque

  Par défaut, l’architecture des fichiers binaires .NET à installer représente l’architecture du système d’exploitation en cours d’exécution. Pour spécifier une architecture de système d’exploitation différente, consultez dotnet tool install, --arch option. Pour plus d'informations, consultez le problème GitHub dotnet/AspNetCore.Docs n° 29262.

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet RazorPagesMovie>Ajouter>Nouveau dossier. Nommez le dossier Models.

2. Cliquez avec le bouton droit sur le dossier Models. Sélectionnez Ajouter>Classe. Nommez la classe Movie.

3. Ajoutez les propriétés suivantes à la classe Movie :

   using System;
   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; }
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; }
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• [DataType(DataType.Date)] : l’attribut [DataType] spécifie le type de données (Date). Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

1. Ajoutez un dossier nommé Models.
2. Ajoutez une classe au dossier Models nommé Movie.cs.

Ajoutez les propriétés suivantes à la classe Movie :

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• [DataType(DataType.Date)] : l’attribut [DataType] spécifie le type de données (Date). Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Ajouter des packages NuGet des outils EF

Exécutez les commandes CLI .NET suivantes :

dotnet tool install --global dotnet-ef
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer

Les commandes précédentes ajoutent :

• Outils de l’interface de ligne de commande (CLI) pour EF Core
• Outil de génération de modèles automatique aspnet-codegenerator.
• Outils de temps de conception pour EF Core
• Le fournisseur EF Core SQLite, qui installe le package EF Core comme une dépendance.
• Les packages nécessaires à la génération de modèles automatique : Microsoft.VisualStudio.Web.CodeGeneration.Design et Microsoft.EntityFrameworkCore.SqlServer.

Pour obtenir de l’aide sur la configuration de plusieurs environnements qui permet à une application de configurer ses contextes de base de données par environnement, consultez Utiliser plusieurs environnements dans ASP.NET Core.

Si vous obtenez une erreur de structure, vérifiez que le moniker de framework cible (TFM) correspond à la version du package NuGet dans le fichier projet. Par exemple, le fichier de projet suivant utilise la version 5.0 pour .NET et les packages NuGet répertoriés :

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="5.0.0-*" />
  </ItemGroup>

</Project>

1. Dans la fenêtre Outil solution, cliquez sur le projet RazorPagesMovie, puis sélectionnez Ajouter>Nouveau dossier.... Nommez le dossier Models.

2. Cliquez sur le dossier Models, puis sélectionnez Ajouter>Nouveau fichier....

3. Dans la boîte de dialogue Nouveau fichier :

   1. Dans le volet gauche, sélectionnez Général.
   2. Dans le volet central, sélectionnez Classe vide.
   3. Nommez la classe Movie, puis sélectionnez Nouveau.

4. Ajoutez les propriétés suivantes à la classe Movie :

   using System;
   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; }
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; }
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• [DataType(DataType.Date)] : l’attribut [DataType] spécifie le type de données (Date). Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

1. Créer un dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

2. Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvel élément généré automatiquement.

   

3. Dans la boîte de dialogue Ajouter une génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

4. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la liste déroulante Classe de modèle, sélectionnez Film (RazorPagesMovie.Models).
   2. Dans la ligne Classe du contexte de données, sélectionnez le signe + (plus).
      1. Dans la boîte de dialogue Ajouter un contexte de données, le nom de la classe RazorPagesMovie.Data.RazorPagesMovieContext est généré.
   3. Sélectionnez Ajouter.

   

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

• Ouvrez un interpréteur de commandes dans le répertoire du projet, qui contient les fichiers Program.cs, Startup.cs et .csproj. Exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries -sqlite
  

Le tableau suivant détaille les paramètres du générateur de code ASP.NET Core.

Utilisez l’option -h pour obtenir de l’aide sur la commande dotnet aspnet-codegenerator razorpage :

dotnet aspnet-codegenerator razorpage -h

Pour plus d’informations, consultez dotnet aspnet-codegenerator.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment injecter IWebHostEnvironment dans Startup. IWebHostEnvironment est injecté donc ConfigureServices peut utiliser SQLite dans le développement et SQL Server en production.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

1. Créer un dossier Pages/Movies :

   1. Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
   2. Nommez le dossier Movies.

2. Cliquez sur le dossier Pages/Movies >Ajouter>Nouvelle génération de modèles automatique....

   

3. Dans la boîte de dialogue Nouvelle génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

   

4. Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

   1. Dans la ligne classe DbContext à utiliser :, nommez la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   2. Sélectionnez Terminer.

   

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment injecter IWebHostEnvironment dans Startup. IWebHostEnvironmentest injecté et ConfigureServices peut donc utiliser SQLite dans le développement et SQL Server dans la production.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Dans cette section, la fenêtre Console du gestionnaire de package est utilisée pour :

• Ajouter une migration initiale
• Mettez à jour la base de données avec la migration initiale.

1. Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Console du gestionnaire de package.

   

2. Dans la console du Gestionnaire de package, entrez les commandes suivantes :

   Add-Migration InitialCreate
   Update-Database
   

• Exécutez les commandes CLI .NET suivantes :

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

Examiner le contexte inscrit avec l’injection de dépendances

ASP.NET Core comprend l’injection de dépendances. Des services, tels que le contexte de base de données EF Core, sont inscrits avec l’injection de dépendance au démarrage de l’application. Ces services sont affectés aux composants qui les nécessitent (par exemple les Pages Razor) par le biais de paramètres de constructeur. Le code de constructeur qui obtient une instance de contexte de base de données est indiqué plus loin dans le tutoriel.

L’outil de génération de modèles automatique a créé automatiquement un contexte de base de données et l’a inscrit dans le conteneur d’injection de dépendances.

Examinez la méthode Startup.ConfigureServices. La ligne en surbrillance a été ajoutée par l’outil de génération de modèles automatique :

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

Le RazorPagesMovieContext coordonne les fonctionnalités EF Core, telles que Créer, Lire, Mettre à jour et Supprimer, pour le modèle Movie. Le contexte de données (RazorPagesMovieContext) est dérivé de Microsoft.EntityFrameworkCore.DbContext. Il spécifie les entités qui sont incluses dans le modèle de données.

using Microsoft.EntityFrameworkCore;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (
            DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
    }
}

Le code précédent crée une propriété DbSet<Movie> pour le jeu d’entités. Dans la terminologie Entity Framework, un jeu d’entités correspond généralement à une table de base de données. Une entité correspond à une ligne dans la table.

Le nom de la chaîne de connexion est transmis au contexte en appelant une méthode sur un objet DbContextOptions. Pour le développement local, le système de configuration lit la chaîne de connexion à partir du fichier appsettings.json.

Examinez la méthode Up.

Cliquez avec le bouton droit sur le projet RazorPagesMovie >Ajouter>Nouveau dossier. Nommez le dossier Models.

Cliquez avec le bouton droit sur le dossier Models. Sélectionnez Ajouter>Classe. Nommez la classe Movie.

Ajoutez les propriétés suivantes à la classe Movie :

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• [DataType(DataType.Date)] : L’attribut DataType spécifie le type de données (Date). Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Les DataAnnotations sont traitées dans un prochain didacticiel.

• Ajoutez un dossier nommé Models.
• Ajoutez une classe au dossier Models nommé Movie.cs.

Ajoutez les propriétés suivantes à la classe Movie :

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• [DataType(DataType.Date)] : L’attribut DataType spécifie le type de données (Date). Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Les DataAnnotations sont traitées dans un prochain didacticiel.

Ajouter des packages NuGet des outils EF

Exécutez les commandes CLI .NET suivantes :

dotnet tool install --global dotnet-ef --version 3.1.9
dotnet tool install --global dotnet-aspnet-codegenerator --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 3.1.9
dotnet add package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore --version 3.1.9
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Design --version 3.1.9
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --version 3.1.9
dotnet add package Microsoft.Extensions.Logging.Debug --version 3.1.9

Les commandes précédentes ajoutent :

• Outil de génération de modèles automatique aspnet-codegenerator.
• Les outils Entity Framework Core pour la CLI .NET.
• Le fournisseur EF Core SQLite, qui installe le package EF Core comme une dépendance.
• Les packages nécessaires à la génération de modèles automatique : Microsoft.VisualStudio.Web.CodeGeneration.Design et Microsoft.EntityFrameworkCore.SqlServer.

Pour obtenir de l’aide sur la configuration de plusieurs environnements qui permet à une application de configurer ses contextes de base de données par environnement, consultez Utiliser plusieurs environnements dans ASP.NET Core.

Si vous obtenez une erreur de structure, vérifiez que le moniker de framework cible (TFM) correspond à la version du package NuGet dans le fichier projet. Par exemple, le fichier projet suivant contient la version 3.1 pour .NET Core et les packages NuGet répertoriés :

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="3.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="3.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.1.0" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="3.1.0" />
  </ItemGroup>

</Project>

Ajouter une classe de contexte de base de données

• Dans le projet RazorPagesMovie, créez un nouveau dossier nommé Data.

• Ajoutez la classe RazorPagesMovieContext suivante au dossier Data :

  using Microsoft.EntityFrameworkCore;
  
  namespace RazorPagesMovie.Data
  {
      public class RazorPagesMovieContext : DbContext
      {
          public RazorPagesMovieContext (
              DbContextOptions<RazorPagesMovieContext> options)
              : base(options)
          {
          }
  
          public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
      }
  }
  

Le code précédent crée une propriété DbSet pour le jeu d’entités. Dans la terminologie Entity Framework, un jeu d’entités correspond généralement à une table de base de données, et une entité correspond à une ligne dans la table. Le code ne sera pas compilé tant que les dépendances n’auront pas été ajoutées à une étape ultérieure.

Ajouter une chaîne de connexion de base de données

Ajoutez une chaîne de connexion au fichier appsettings.json comme indiqué dans le code en surbrillance suivant :

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

Inscrire le contexte de base de données

En tête du Startup.cs, ajoutez les instructions using suivantes :

using RazorPagesMovie.Data;
using Microsoft.EntityFrameworkCore;

Inscrivez le contexte de base de données auprès du conteneur d’injection de dépendances dans Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

• Dans la fenêtre Outil solution, cliquez sur le projet RazorPagesMovie, puis sélectionnez Ajouter>Nouveau dossier.... Nommez le dossier Models.

• Cliquez avec le bouton droit sur le dossier Models, puis sélectionnez Ajouter>Nouveau fichier.

• Dans la boîte de dialogue Nouveau fichier :

  • Dans le volet gauche, sélectionnez Général.
  • Dans le volet central, sélectionnez Classe vide.
  • Nommez la classe Movie, puis sélectionnez Nouveau.

Ajoutez les propriétés suivantes à la classe Movie :

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contient :

• Le champ ID est nécessaire à la base de données pour la clé primaire.

• [DataType(DataType.Date)] : L’attribut DataType spécifie le type de données (Date). Avec cet attribut :

  • L’utilisateur n’est pas obligé d’entrer les informations de temps dans le champ de date.
  • Seule la date est affichée, pas les informations de temps.

Créer un dossier Pages/Movies :

• Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
• Nommez le dossier Movies.

Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvel élément généré automatiquement.

Dans la boîte de dialogue Ajouter une génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

• Dans la liste déroulante Classe de modèle, sélectionnez Film (RazorPagesMovie.Models).
• Dans la ligne Classe du contexte de données, sélectionnez le signe (plus) + et changez le nom généré de RazorPagesMovie.Models.RazorPagesMovieContext en RazorPagesMovie.Data.RazorPagesMovieContext. Cette modification n'est pas requise. Elle crée la classe de contexte de base de données avec l’espace de noms correct.
• Sélectionnez Ajouter.

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

• Ouvrez une fenêtre de commandes dans le répertoire du projet, qui contient les fichiers Program.cs, Startup.cs et .csproj.

• Pour Windows, exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages\Movies --referenceScriptLibraries
  

• Pour macOS et Linux, exécutez la commande suivante :

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries
  

Le tableau suivant détaille les paramètres du générateur de code ASP.NET Core :

Utilisez l’option -h pour obtenir de l’aide sur la commande dotnet aspnet-codegenerator razorpage :

dotnet aspnet-codegenerator razorpage -h

Pour plus d’informations, consultez dotnet aspnet-codegenerator.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment injecter IWebHostEnvironment dans Start-up. IWebHostEnvironment est injecté donc ConfigureServices peut utiliser SQLite dans le développement et SQL Server en production.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseDatabaseErrorPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Créer un dossier Pages/Movies :

• Cliquez avec le bouton droit sur le dossier Pages >Ajouter>Nouveau dossier.
• Nommez le dossier Movies.

Cliquez avec le bouton droit sur le dossier Pages/Movies >Ajouter>Nouvelle génération de modèles automatique....

Dans la boîte de dialogue Nouvelle génération de modèles automatique, sélectionnez Pages Razor utilisant Entity Framework (CRUD)>Ajouter.

Renseignez la boîte de dialogue Ajouter des pages Razor avec Entity Framework (CRUD) :

• Dans la liste déroulante Classe de modèle, sélectionnez ou entrez Film (RazorPagesMovie.Models).
• Dans la ligne Classe de contexte de données, tapez le nom de la nouvelle classe, RazorPagesMovie.Données.RazorPagesMovieContext. Cette modification n'est pas requise. Elle crée la classe de contexte de base de données avec l’espace de noms correct.
• Sélectionnez Ajouter.

Le fichier appsettings.json est mis à jour avec la chaîne de connexion utilisée pour se connecter à une base de données locale.

Ajouter des outils EF

Exécutez la commande CLI .NET suivante :

dotnet tool install --global dotnet-ef

La commande précédente ajoute les outils Entity Framework Core pour l’interface de ligne de commande .NET. Pour plus d’informations, consultez Informations de référence sur les outils Entity Framework Core - interface de ligne de commande .NET.

Utiliser SQLite pour le développement, SQL Server pour la production

Lorsque SQLite est sélectionné, le code généré par le modèle est prêt pour le développement. Le code suivant montre comment injecter IWebHostEnvironment dans Start-up. IWebHostEnvironment est injecté donc ConfigureServices peut utiliser SQLite dans le développement et SQL Server en production.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseDatabaseErrorPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Le processus de génération de modèles automatique crée et met à jour les fichiers suivants :

• Pages/Movies : Create, Delete, Details, Edit, Index.
• Data/RazorPagesMovieContext.cs

Mis à jour

• Startup.cs

Les fichiers créés et mis à jour sont expliqués dans la section suivante.

Le processus de génération de modèles automatique crée et met à jour les fichiers suivants :

• Pages/Movies : Create, Delete, Details, Edit, Index.
• Data/RazorPagesMovieContext.cs

Mis à jour

• Startup.cs

Les fichiers créés et mis à jour sont expliqués dans la section suivante.

Le processus de génération de modèles automatique crée les fichiers suivants :

• Pages/Movies : Create, Delete, Details, Edit, Index.

Les fichiers créés sont expliqués dans la section suivante.

Dans cette section, la console du gestionnaire de package est utilisée pour :

• Ajouter une migration initiale
• Mettez à jour la base de données avec la migration initiale.

Dans le menu Outils, sélectionnez Gestionnaire de package NuGet>Console du gestionnaire de package.

Dans la console du Gestionnaire de package, entrez les commandes suivantes :

Add-Migration InitialCreate
Update-Database

Si dotnet ef n’a pas été installé, installez-le en tant qu’outil global :

  dotnet tool install --global dotnet-ef

Pour plus d’informations sur la CLI pour EF Core, consultez informations de référence sur les outils EF Core de la CLI .NET.

Exécutez les commandes CLI .NET suivantes :

dotnet ef migrations add InitialCreate
dotnet ef database update

Examiner le contexte inscrit avec l’injection de dépendances

ASP.NET Core comprend l’injection de dépendances. Des services, tels que le contexte de base de données EF Core, sont inscrits avec l’injection de dépendance au démarrage de l’application. Les composants qui nécessitent ces services, par exemple les pages Razor, sont fournis par le biais de paramètres de constructeur. Le code de constructeur qui obtient une instance de contexte de base de données est indiqué plus loin dans le tutoriel.

L’outil de génération de modèles automatique a créé automatiquement un contexte de base de données et l’a inscrit dans le conteneur d’injection de dépendances.

Examinez la méthode Startup.ConfigureServices. La ligne en surbrillance a été ajoutée par l’outil de génération de modèles automatique :

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

Le RazorPagesMovieContext coordonne les fonctionnalités EF Core, telles que Créer, Lire, Mettre à jour et Supprimer, pour le modèle Movie. Le contexte de données (RazorPagesMovieContext) est dérivé de Microsoft.EntityFrameworkCore.DbContext. Il spécifie les entités qui sont incluses dans le modèle de données.

using Microsoft.EntityFrameworkCore;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (
            DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
    }
}

Le code précédent crée une propriété DbSet<Movie> pour le jeu d’entités. Dans la terminologie Entity Framework, un jeu d’entités correspond généralement à une table de base de données. Une entité correspond à une ligne dans la table.

Le nom de la chaîne de connexion est transmis au contexte en appelant une méthode sur un objet DbContextOptions. Pour le développement local, le système de configuration lit la chaîne de connexion à partir du fichier appsettings.json.

Examinez la méthode Up.