Préparer le projet
PostgreSQL, un projet C# et le package dont on a besoin.
Après cette fiche, vous saurez :
- vérifier que PostgreSQL et pgAdmin sont prêts
- créer un projet console
- dire à quoi sert chaque package NuGet
- ajouter le package avec la commande dotnet
1Ce qu'il faut sur l'ordinateur
Trois choses doivent être installées avant de commencer.
| Outil | À quoi il sert | Où l'installer |
|---|---|---|
| PostgreSQL | Le moteur de base de données, qui range les données. | Fiche 5 du cours Bases de données. |
| pgAdmin | La fenêtre pour regarder la base et vérifier le résultat. | Installé avec PostgreSQL. |
| Le SDK .NET 10 et un éditeur | De 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
- Créer un projet Choisissez Application console (C#).
- Le nommer
Par exemple
Demo_Cinema. Pas d'espace, pas d'accent. - 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_Cinema3Le 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.
| Package | Son rôle |
|---|---|
Microsoft.EntityFrameworkCore | Entity Framework Core : le traducteur. Il arrive tout seul avec le package suivant. |
Npgsql.EntityFrameworkCore.PostgreSQL | Le 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
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
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.
- Dans le dossier du projet, ajoutez le package
Npgsql.EntityFrameworkCore.PostgreSQLen version10.0.3. - Ouvrez le fichier
.csprojdans un éditeur. Quelle ligne a été ajoutée ? - 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.
- Créez les dossiers
ModeletContext. - Dans
Model, créez une classe videFilm. - Vérifiez que
dotnet buildré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
- PostgreSQL tourne et je connais mon mot de passe.
- J'ai créé un projet console .NET 10.
- Je sais à quoi servent Entity Framework Core et Npgsql.EntityFrameworkCore.PostgreSQL.
- Je sais ajouter un package avec dotnet add package.
Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.