Pour vérifier le contenu de votre base SQLite, vous pouvez utiliser le programme *DB Browser* :
* Rendez-vous sur la page : https://sqlitebrowser.org/dl/ et téléchargez le programme *DB Browser*.
* Lancez *DB Browser for SQLite*
* Glissez-déposez au milieu de la fenêtre de *DB Browser for SQLite* le fichier *ex_042_014_OneToMany_dataAnnotations.Nounours.db* qui a été généré par l'exécution du programme et qui se trouve près de *ex_042_014_OneToMany_dataAnnotations.csproj*.
* Glissez-déposez au milieu de la fenêtre de *DB Browser for SQLite* le fichier
* *ex_042_014_OneToMany_dataAnnotations.Albums.db* qui a été généré par l'exécution du programme et qui se trouve près de *ex_042_014_OneToMany_dataAnnotations.csproj*.
![DB Browser for SQLite](./readme_files/dbbrowser01.png)
* Choisissez ensuite l'onglet *Parcourir les données*
new { MorceauId = 2, AlbumId = 1, Titre = "Freddie Freeloader" },
new { MorceauId = 3, AlbumId = 1, Titre = "Blue in Green" },
new { MorceauId = 4, AlbumId = 1, Titre = "All Blues" },
new { MorceauId = 5, AlbumId = 1, Titre = "Flamenco Sketches" },
new { MorceauId = 6, AlbumId = 2, Titre = "Catta" },
new { MorceauId = 7, AlbumId = 2, Titre = "Idle While" },
new { MorceauId = 8, AlbumId = 2, Titre = "Les Noirs Marchant" },
new { MorceauId = 9, AlbumId = 2, Titre = "Dialogue" },
new { MorceauId = 10, AlbumId = 2, Titre = "Ghetto Lights" },
new { MorceauId = 11, AlbumId = 2, Titre = "Jasper" }
);
}
```
* Remarquez que __À AUCUN MOMENT__ nous ne précisons les valeurs des propriétés ```Album``` de ```Morceau``` et ```Morceaux``` de ```Album```.
Le simple fait d'utiliser la clé étrangère (propriété ```AlbumForeignKey```) dans ```Morceau``` est suffisant.
* Notez que ce ne sera pas le cas lors d'une utilisation *classique* de nos classes (ajout, modification...). Nous ne donnerons plus les identifiants directement mais les références des propriétés ```Morceaux``` et ```Album```.
* __Attention toutefois__, ici, puisque nous devons donner la clé étrangère, il faut
d'abord ajouter une colonne (une propriété) à notre entité ```Morceau```, qui permettra
de stocker la clé étrangère pour pointer l'```Album``` associé :
* Remarquez que __À AUCUN MOMENT__ nous ne précisons les valeurs des propriétés
```Album``` de ```Morceau``` et ```Morceaux``` de ```Album```.
Le simple fait d'utiliser la clé étrangère (propriété ```AlbumId```
ajoutée précédemment) dans ```Morceau``` est suffisant.
* Notez que ce ne sera pas le cas lors d'une utilisation *classique* de nos classes
(ajout, modification...). Nous ne donnerons plus les identifiants directement mais
les références des propriétés ```Morceaux``` et ```Album```.
### La classe ```Program```
* On affiche tout d'abord le contenu de la base (c'est-à-dire rien ou d'anciennes données si la migration est faite à partir de ```AlbumDBEntites```) ou le stub (si la migration est faite à partir de ```StubbedContext```).
*Notez l'utilisation d'```Include``` dans ```db.Albums.Include(a => a.Morceaux)``` sinon, les ```Morceau``` ne sont pas chargés.
```Include``` n'est pas utilisé ensuite dans ```db.Morceaux``` car les ```Album``` ont déjà été chargés depuis la connexion.
Mais on aurait pu faire les accès dans l'autre sens et dans ce cas d'abord ```db.Morceaux.Include(m => m.Album)``` puis simplement ```db.Albums```.*
* On affiche tout d'abord le contenu de la base (c'est-à-dire rien ou d'anciennes
données si la migration est faite à partir de ```AlbumDBEntites```) ou le stub
(si la migration est faite à partir de ```StubbedContext```).
*Notez l'utilisation d'```Include``` dans
```db.Albums.Include(a => a.Morceaux)``` sinon, les ```Morceau``` ne sont pas
chargés.
```Include``` n'est pas utilisé ensuite dans ```db.Morceaux``` car les
```Album``` ont déjà été chargés depuis la connexion.
Mais on aurait pu faire les accès dans l'autre sens et dans ce cas d'abord
```db.Morceaux.Include(m => m.Album)``` puis simplement ```db.Albums```.*
```csharp
using (AlbumDBEntities db = new AlbumDBEntities())
{
@ -202,32 +221,40 @@ using (AlbumDBEntities db = new AlbumDBEntities())
}
```
## Comment exécuter cet exemple ?
Pour tester cette application, n'oubliez pas les commandes comme présentées dans l'exemple ex_041_001 : pour générer l'exemple, il vous faut d'abord préparer les migrations et les tables.
* Ouvrez la *Console du Gestionnaire de package* sous Windows (pour cela, dirigez-vous dans le menu *Outils*, puis *Gestionnaire de package NuGet*, puis *Console du Gestionnaire de package*) ou le *Terminal* sous MacOSX.
* Dans la console que vous venez d'ouvrir, déplacez-vous dans le dossier du projet .NET Core, ici :
Pour tester cette application, n'oubliez pas les commandes comme présentées dans
l'exemple ex_041_001 : pour générer l'exemple, il vous faut d'abord préparer les
migrations et les tables.
* Ouvrez la *Console du Gestionnaire de package* sous Windows (pour cela,
dirigez-vous dans le menu *Outils*, puis *Gestionnaire de package NuGet*, puis
*Console du Gestionnaire de package*) ou le *Terminal* sous MacOSX.
* Dans la console que vous venez d'ouvrir, déplacez-vous dans le dossier du projet
.NET Core, ici :
```
cd .\p08_BDD_EntityFramework\ex_042_014_OneToMany_dataAnnotations
cd .\p08_BDD_EntityFramework\ex_042_015_OneToMany_conventions
```
*Note*:
si vous n'avez pas installé correctement EntityFrameworkCore, il vous faudra peut-être utiliser également :
si vous n'avez pas installé correctement EntityFrameworkCore, il vous faudra
peut-être utiliser également :
* ```dotnet tool install --global dotnet-ef``` si vous utilisez la dernière version de .NET Core (3.1 aujourd'hui),
* Migration : vous devez préciser la classe fille de ```DbContext``` à utiliser : soit ```AlbumDBEntities```, soit ```StubbedContext```.
* Migration : vous devez préciser la classe fille de ```DbContext``` à utiliser :
soit ```AlbumDBEntities```, soit ```StubbedContext```.
```
dotnet ef migrations add ex_042_014 --context StubbedContext
dotnet ef migrations add ex_042_015 --context StubbedContext
```
* Création de la table :
```
dotnet ef database update --context StubbedContext
```
* Génération et exécution
Vous pouvez maintenant générer et exécuter l'exemple **ex_042_014_OneToMany_dataAnnotations**.
Vous pouvez maintenant générer et exécuter l'exemple **ex_042_015_OneToMany_conventions**.
* Le résultat de l'exécution va ressembler à (si vous avez utilisé ```StubbedContext```) :
* Le résultat de l'exécution va ressembler à (si vous avez utilisé
```StubbedContext```) :
```
Albums :
1: Kind of Blue (sorti le : 17/08/1959)
@ -302,12 +329,14 @@ Morceaux :
```
## Comment exécuter cet exemple sans le stub ?
Il suffit de faire exactement comme dans le paragraphe précédent, mais en choisissant le contexte ```AlbumDBEntities``` à la place de ```StubbedContext``` :
Il suffit de faire exactement comme dans le paragraphe précédent, mais en choisissant
le contexte ```AlbumDBEntities``` à la place de ```StubbedContext``` :
```
dotnet ef migrations add ex_042_014 --context AlbumDBEntities
dotnet ef migrations add ex_042_015 --context AlbumDBEntities
dotnet ef database update --context AlbumDBEntities
```
Lors de l'exécution, le résultat sera évidemment différent puisqu'il n'y aura pas les 2 albums du stub.
Lors de l'exécution, le résultat sera évidemment différent puisqu'il n'y aura pas les
2 albums du stub.
Il pourra ressembler à :
```
Albums :
@ -338,7 +367,9 @@ Morceaux :
Pour vérifier le contenu de votre base SQLite, vous pouvez utiliser le programme *DB Browser* :
* Rendez-vous sur la page : https://sqlitebrowser.org/dl/ et téléchargez le programme *DB Browser*.
* Lancez *DB Browser for SQLite*
* Glissez-déposez au milieu de la fenêtre de *DB Browser for SQLite* le fichier *ex_042_014_OneToMany_dataAnnotations.Nounours.db* qui a été généré par l'exécution du programme et qui se trouve près de *ex_042_014_OneToMany_dataAnnotations.csproj*.
* Glissez-déposez au milieu de la fenêtre de *DB Browser for SQLite* le fichier
*ex_042_015_OneToMany_conventions.Albums.db* qui a été généré par l'exécution du
programme et qui se trouve près de *ex_042_015_OneToMany_conventions.csproj*.
![DB Browser for SQLite](./readme_files/dbbrowser01.png)
* Choisissez ensuite l'onglet *Parcourir les données*