⌂ Entity Framework
Fiche 2 sur 8

Préparer le projet

PostgreSQL, un projet C# et le package dont on a besoin.

Après cette fiche, vous saurez :

1Ce qu'il faut sur l'ordinateur

Trois choses doivent être installées avant de commencer.

OutilÀ quoi il sertOù l'installer
PostgreSQLLe moteur de base de données, qui range les données.Fiche 5 du cours Bases de données.
pgAdminLa fenêtre pour regarder la base et vérifier le résultat.Installé avec PostgreSQL.
Le SDK .NET 10 et un éditeurDe quoi écrire et lancer du C#.Installé avec Visual Studio, ou sur dotnet.microsoft.com.

Attention

Notez votre mot de passe PostgreSQL.

Votre programme en aura besoin pour se connecter (fiche 6). Il n'existe aucun moyen simple de le retrouver s'il est perdu.

Une bonne nouvelle : vous n'avez pas besoin de créer la base dans pgAdmin. C'est Entity Framework qui la créera. pgAdmin ne servira qu'à vérifier ensuite que tout est bien là.

2Créer le projet

Nous utilisons un projet console : un programme sans fenêtre, qui s'exécute et s'arrête. C'est le plus simple pour apprendre.

Avec Visual Studio

  1. Créer un projet Choisissez Application console (C#).
  2. Le nommer Par exemple Demo_Cinema. Pas d'espace, pas d'accent.
  3. Choisir .NET 10 Dans la liste des frameworks. Retenez ce numéro : il sera important à la fiche 3.

Ou avec une seule commande

Dans un terminal, placé dans le dossier où vous rangez vos projets :

dotnet new console -n Demo_Cinema
cd Demo_Cinema

3Le package dont on a besoin

Un package (ou paquet NuGet) est un morceau de code écrit par d'autres, que vous ajoutez à votre projet au lieu de le réécrire. Pour ce cours, deux packages travaillent ensemble.

PackageSon rôle
Microsoft.EntityFrameworkCoreEntity Framework Core : le traducteur. Il arrive tout seul avec le package suivant.
Npgsql.EntityFrameworkCore.PostgreSQLLe pilote qui apprend à Entity Framework à parler à PostgreSQL. C'est lui que vous ajoutez.

En pratique, vous n'avez qu'une seule commande à lancer. Le package Npgsql amène Entity Framework Core avec lui, comme un colis qui contient son emballage.

À retenir

Pour ce cours, un seul package à ajouter : Npgsql.EntityFrameworkCore.PostgreSQL.

Il n'y a pas besoin du package Design ni de l'outil dotnet-ef : ils servent aux migrations, que nous n'utilisons pas ici.

4Ajouter le package

Dans le terminal, dans le dossier du projet (celui qui contient le fichier .csproj) :

dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 10.0.3

Remarquez la fin de la commande : --version 10.0.3. Elle n'est pas facultative pour nous, et la fiche suivante explique pourquoi.

Ensuite, vérifiez que le projet compile toujours :

dotnet build
Résultat
Build succeeded.
    0 Warning(s)
    0 Error(s)

5Ranger son projet

On sépare le code en deux dossiers, comme dans le projet du cinéma.

Demo_Cinema/
  Model/       les classes : Film, Genre, Salle, Seance, Ticket
  Context/     le DbContext (fiche 6)
  Program.cs   le programme qui crée la base (fiche 7)
  Demo_Cinema.csproj

Le dossier Model (le modèle) contient les classes qui deviendront des tables. Le dossier Context contiendra la classe qui fait le lien avec la base. Pour l'instant, créez simplement ces deux dossiers vides.

→Exercices

1Créer le projetRecopier

Créez un projet console nommé Demo_Cinema (avec Visual Studio ou avec dotnet new console) puis lancez-le avec dotnet run.

Solution

Le programme affiche Hello, World! : c'est le programme par défaut.

Si dotnet run ne trouve rien, vérifiez que le terminal est bien dans le dossier du projet, celui qui contient le fichier .csproj.

2Ajouter le packageModifier
  1. Dans le dossier du projet, ajoutez le package Npgsql.EntityFrameworkCore.PostgreSQL en version 10.0.3.
  2. Ouvrez le fichier .csproj dans un éditeur. Quelle ligne a été ajoutée ?
  3. Lancez dotnet build.

Solution

1.

dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 10.0.3

2. Une ligne PackageReference avec le nom du package et sa version a été ajoutée dans un bloc ItemGroup.

3. Le résultat doit être Build succeeded. Si des erreurs apparaissent, relisez la commande : une faute de frappe dans le nom du package est la cause la plus fréquente.

3Un projet bien rangéCréer
  1. Créez les dossiers Model et Context.
  2. Dans Model, créez une classe vide Film.
  3. Vérifiez que dotnet build réussit encore.

Solution

Une classe vide compile sans problème :

namespace Demo_Cinema.Model
{
    public class Film
    {
    }
}

Le namespace reprend le nom du projet suivi du nom du dossier : c'est ce que Visual Studio fait automatiquement quand on crée la classe dans le dossier Model.

Je sais faire

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

← Fiche 1 Fiche 3 : Les versions des packages →