⌂ Entity Framework
Fiche 7 sur 8

Créer la base avec EnsureCreated

Une seule ligne de C#, et PostgreSQL contient la base et ses tables.

Après cette fiche, vous saurez :

1Le modèle complet, sans relations

Avant de créer la base, rassemblons les cinq classes du cinéma. Les relations entre elles viendront à la fiche suivante : pour l'instant, chaque table est seule.

Rangez-les dans le dossier Model, une classe par fichier.

using System.ComponentModel.DataAnnotations;
using Microsoft.EntityFrameworkCore;

namespace Demo_Cinema.Model
{
    [Index(nameof(Libelle), IsUnique = true)]
    public class Genre
    {
        [Key]
        public int IdGenre { get; set; }

        [Required]
        [MaxLength(30)]
        public required string Libelle { get; set; }
    }
}
using System.ComponentModel.DataAnnotations;
using Microsoft.EntityFrameworkCore;

namespace Demo_Cinema.Model
{
    [Index(nameof(NumeroSalle), IsUnique = true)]
    public class Salle
    {
        [Key]
        public int IdSalle { get; set; }

        public int NumeroSalle { get; set; }

        public int Capacite { get; set; }

        public bool Est3d { get; set; }
    }
}
using System.ComponentModel.DataAnnotations;

namespace Demo_Cinema.Model
{
    public class Film
    {
        [Key]
        public int IdFilm { get; set; }

        [Required]
        [MaxLength(60)]
        public required string Titre { get; set; }

        [MaxLength(40)]
        public required string Realisateur { get; set; }

        public int Annee { get; set; }

        public int DureeMinutes { get; set; }

        public string? Synopsis { get; set; }
    }
}
using System.ComponentModel.DataAnnotations;

namespace Demo_Cinema.Model
{
    public class Seance
    {
        [Key]
        public int IdSeance { get; set; }

        public DateOnly DateSeance { get; set; }

        public int HeureSeance { get; set; }

        public int MinuteSeance { get; set; }

        public double PrixBase { get; set; }

        public string? Remarques { get; set; }
    }
}
using System.ComponentModel.DataAnnotations;
using Microsoft.EntityFrameworkCore;

namespace Demo_Cinema.Model
{
    [Index(nameof(NumTicket), IsUnique = true)]
    public class Ticket
    {
        [Key]
        public int IdTicket { get; set; }

        [Required]
        [MaxLength(20)]
        public required string NumTicket { get; set; }

        public int NumeroPlace { get; set; }

        public required string Tarif { get; set; }

        public double PrixPaye { get; set; }

        public DateOnly DateAchat { get; set; }

        public bool EstUtilise { get; set; }
    }
}

Et le AppDbContext de la fiche 6, avec ses cinq DbSet, dans le dossier Context.

2Le programme complet

Voici le fichier Program.cs :

using Demo_Cinema.Context;
using Microsoft.EntityFrameworkCore;

var options = new DbContextOptionsBuilder<AppDbContext>()
    .UseNpgsql("Host=localhost;Database=db_cinema;Username=postgres;Password=VotreMotDePasse")
    .Options;

using var db = new AppDbContext(options);

bool creee = db.Database.EnsureCreated();

Console.WriteLine(creee
    ? "La base vient d'être créée."
    : "La base existait déjà : rien n'a été fait.");

La ligne qui fait tout le travail est db.Database.EnsureCreated(). Son nom veut dire « assure-toi que la base est créée ». Elle renvoie true si elle vient de créer quelque chose, et false si la base était déjà là.

Lancez le programme avec dotnet run (ou le bouton ▶ de Visual Studio) :

Au premier lancement
La base vient d'être créée.
Au deuxième lancement
La base existait déjà : rien n'a été fait.

Au deuxième lancement, rien ne s'est passé : c'est normal, et utile, comme nous allons le voir.

3Ce que fait EnsureCreated, et ce qu'il ne fait pas

EnsureCreated() Que trouve-t-il dans PostgreSQL ? Pas de base Crée la base et toutes les tables Une base vide Crée les tables dans cette base Des tables existent Ne fait rien du tout, même si vos classes ont changé Il ne compare jamais vos classes avec les tables déjà présentes.

Selon ce qu'il trouve dans PostgreSQL, il agit ainsi :

SituationCe qu'il fait
La base n'existe pasCrée la base et toutes les tables.
La base existe mais n'a aucune tableCrée les tables.
La base a déjà des tablesNe fait rien, même si vos classes ont changé depuis.

Attention

EnsureCreated() ne met jamais une table à jour.

Si vous ajoutez une propriété à Film après avoir créé la base, la table Films ne reçoit pas la nouvelle colonne. Entity Framework ne compare pas vos classes avec les tables : il constate que des tables existent, et s'arrête.

Il existe un outil pour faire évoluer une base sans la perdre, les migrations. Nous ne les utilisons pas dans ce cours.

4Vérifier dans pgAdmin

  1. Ouvrir pgAdmin Connectez-vous au serveur avec votre mot de passe.
  2. Actualiser la liste Clic droit sur Databases, puis Refresh. La base db_cinema apparaît.
  3. Descendre jusqu'aux tables Dépliez db_cinema, puis Schemas, public, Tables.
Servers > PostgreSQL 18 > Databases > db_cinema > Schemas > public > Tables

Vous devez y voir vos cinq tables : Films, Genres, Salles, Seances et Tickets.

Pour regarder le contenu d'une table (vide pour l'instant), clic droit sur elle puis View/Edit Data, All Rows. Vous pouvez aussi écrire une requête dans le Query Tool :

SELECT * FROM "Films";

Attention

Les guillemets sont obligatoires.

Dans le cours de bases de données, nous avions pris l'habitude de noms en minuscules. Entity Framework, lui, crée des noms avec des majuscules (Films, IdFilm), et PostgreSQL exige alors des guillemets doubles autour du nom. Sans eux : SELECT * FROM Films donne une erreur.

5Voir le SQL sans créer la base

Curieux de savoir ce qu'Entity Framework va envoyer à PostgreSQL ? Cette ligne affiche le SQL sans toucher à la base :

Console.WriteLine(db.Database.GenerateCreateScript());
Début de ce que le programme affiche
CREATE TABLE "Films" (
    "IdFilm" integer GENERATED BY DEFAULT AS IDENTITY,
    "Titre" character varying(60) NOT NULL,
    "Realisateur" character varying(40) NOT NULL,
    "Annee" integer NOT NULL,
    "DureeMinutes" integer NOT NULL,
    "Synopsis" text,
    CONSTRAINT "PK_Films" PRIMARY KEY ("IdFilm")
);

CREATE TABLE "Genres" (
    "IdGenre" integer GENERATED BY DEFAULT AS IDENTITY,
    "Libelle" character varying(30) NOT NULL,
    CONSTRAINT "PK_Genres" PRIMARY KEY ("IdGenre")
);

...

C'est le même SQL que vous auriez écrit à la main dans le cours de bases de données. C'est aussi un excellent moyen de vérifier une annotation avant de créer la base.

6Repartir de zéro

Vous avez changé une classe ? Puisque EnsureCreated() ne met rien à jour, il faut supprimer la base puis la recréer.

db.Database.EnsureDeleted();   // supprime la base ET toutes ses données
db.Database.EnsureCreated();   // la recrée à partir des classes actuelles

Attention

EnsureDeleted() efface tout, sans demander.

Toutes les données de la base disparaissent. C'est acceptable pendant l'apprentissage, tant que la base ne contient que des données d'essai. Ne l'utilisez jamais sur une base qui contient de vraies données.

Si PostgreSQL refuse de supprimer la base parce qu'elle est utilisée, fermez la connexion de pgAdmin à cette base (clic droit sur la base, Disconnect Database) et recommencez.

Vous pouvez aussi simplement supprimer la base dans pgAdmin (clic droit sur db_cinema, Delete) puis relancer le programme.

7Quand ça ne marche pas

Début du messageCause probable
password authentication failed for user "postgres"Mot de passe incorrect dans la chaîne de connexion.
Failed to connect to ...:5432PostgreSQL n'est pas démarré, ou le port n'est pas 5432.
requires a primary key to be definedIl manque un [Key] sur une classe (fiche 5).

Dans les trois cas, lisez la première ligne du message : elle donne presque toujours la cause.

À retenir

db.Database.EnsureCreated() crée la base et ses tables si elles n'existent pas.

Il ne modifie jamais une table existante. Pour reprendre de zéro : EnsureDeleted() puis EnsureCreated() (toutes les données sont perdues).

→Exercices

1Créer la base du cinémaRecopier

Recopiez les cinq classes et le Program.cs de cette fiche, avec votre mot de passe PostgreSQL. Lancez le programme deux fois de suite.

  1. Qu'affiche-t-il à chaque lancement ?
  2. Dans pgAdmin, combien de tables voyez-vous dans public → Tables ?

Solution

  1. Au premier : La base vient d'être créée. Au deuxième : La base existait déjà : rien n'a été fait.
  2. 5 tables : Films, Genres, Salles, Seances et Tickets. Si la liste est vide, faites un clic droit sur Tables puis Refresh.
2La colonne qui n'apparaît pasModifier
  1. Dans la classe Film, ajoutez la propriété public string? Langue { get; set; }.
  2. Relancez le programme. Regardez la table Films dans pgAdmin. La colonne Langue est-elle là ?
  3. Faites-la apparaître.

Solution

2. Non. Le programme affiche « La base existait déjà » : des tables existaient, donc EnsureCreated() n'a rien changé.

3. Il faut supprimer la base puis la recréer :

db.Database.EnsureDeleted();
bool creee = db.Database.EnsureCreated();

Relancez, puis actualisez pgAdmin : la colonne Langue existe, et elle accepte le NULL à cause du ?. N'oubliez pas de retirer la ligne EnsureDeleted() ensuite, sinon la base est effacée à chaque lancement.

3Une base pour le club de sportCréer

Avec les classes Membre et Cours de la fiche 1 :

  1. Ajoutez les annotations nécessaires (clé, texte obligatoire, longueur).
  2. Écrivez le Program.cs qui crée la base db_club.
  3. Vérifiez les deux tables dans pgAdmin.

Solution

Il n'y a pas une seule solution. Les éléments indispensables :

  • un [Key] sur chaque identifiant ;
  • un DbSet par classe dans le ClubDbContext ;
  • une chaîne de connexion avec Database=db_club ;
  • l'appel db.Database.EnsureCreated().

Dans pgAdmin, vous devez voir Membres et Cours.

Je sais faire

Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.

← Fiche 6 Fiche 8 : Relier deux tables →