Deel 5, Razor Pagina's met EF Core in ASP.NET Core - Gegevensmodel

Door Tom Dykstra, Jeremy Likness en Jon P Smith

De Contoso University-web-app laat zien hoe u webpagina-apps maakt met Razor en Visual Studio EF Core. Zie de eerste zelfstudie voor meer informatie over de reeks zelfstudies.

Als u problemen ondervindt die u niet kunt oplossen, downloadt u de voltooide app en vergelijkt u die code met wat u hebt gemaakt door de zelfstudie te volgen.

De vorige zelfstudies werkten met een basisgegevensmodel dat bestaat uit drie entiteiten. In deze handleiding:

  • Er worden meer entiteiten en relaties toegevoegd.
  • Het gegevensmodel wordt aangepast door opmaak, validatie en databasetoewijzingsregels op te geven.

Het voltooide gegevensmodel wordt weergegeven in de volgende afbeelding:

Entiteitsdiagram

Het volgende databasediagram is gemaakt met Dataedo:

Dataedo-diagram

Een databasediagram maken met Dataedo:

In het voorgaande Dataedo-diagram is de CourseInstructor een koppelings tabel die is gemaakt door Entity Framework. Zie voor meer informatie Veel-op-veel

De entiteit Student

Vervang de code in Models/Student.cs door de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        [Required]
        [StringLength(50)]
        [Display(Name = "Last Name")]
        public string LastName { get; set; }
        [Required]
        [StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Enrollment Date")]
        public DateTime EnrollmentDate { get; set; }
        [Display(Name = "Full Name")]
        public string FullName
        {
            get
            {
                return LastName + ", " + FirstMidName;
            }
        }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

Met de voorgaande code wordt een FullName eigenschap toegevoegd en worden de volgende kenmerken toegevoegd aan bestaande eigenschappen:

De berekende eigenschap FullName

FullName is een berekende eigenschap die een waarde retourneert die wordt gemaakt door twee andere eigenschappen samen te voegen. FullName kan niet worden ingesteld, dus het heeft alleen een 'get'-toegangsmethode. Er wordt geen FullName kolom gemaakt in de database.

Het kenmerk DataType

[DataType(DataType.Date)]

Voor inschrijvingsdatums van leerlingen/studenten worden op alle pagina's het tijdstip van de dag weergegeven, samen met de datum, hoewel alleen de datum relevant is. Met behulp van kenmerken voor gegevensaantekening kunt u één codewijziging aanbrengen waarmee de weergave-indeling wordt hersteld op elke pagina waarin de gegevens worden weergegeven.

Het kenmerk DataType geeft een gegevenstype op dat specifieker is dan het intrinsieke databasetype. In dit geval moet alleen de datum worden weergegeven, niet de datum en tijd. De DataType Enumeratie biedt veel gegevenstypen, zoals Datum, Tijd, Telefoonnummer, Valuta, E-mailadres, enzovoort. Het kenmerk DataType kan de app ook in staat stellen automatisch functies te bieden die specifiek zijn voor het type. Voorbeeld:

  • De mailto: koppeling wordt automatisch gemaakt voor DataType.EmailAddress.
  • De datumkiezer is beschikbaar in DataType.Date de meeste browsers.

Het DataType kenmerk verzendt HTML 5 data--kenmerken (uitgesproken als data streepje). De DataType kenmerken bieden geen validatie.

Het kenmerk DisplayFormat

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

DataType.Date specificeert niet het formaat van de datum die wordt weergegeven. Standaard wordt het datumveld weergegeven volgens de standaardindelingen op basis van de CultureInfo van de server.

Het DisplayFormat kenmerk wordt gebruikt om expliciet de datumnotatie op te geven. De ApplyFormatInEditMode instelling geeft aan dat de opmaak ook moet worden toegepast op de gebruikersinterface voor bewerken. Sommige velden mogen niet worden gebruikt ApplyFormatInEditMode. Het valutasymbool moet in het algemeen niet worden weergegeven in een tekstvak voor bewerken.

Het DisplayFormat kenmerk kan op zichzelf worden gebruikt. Het is over het algemeen een goed idee om het DataType kenmerk te gebruiken met het DisplayFormat kenmerk. Het kenmerk DataType geeft de semantiek van de gegevens weer in plaats van hoe deze op een scherm worden weergegeven. Het DataType kenmerk biedt de volgende voordelen die niet beschikbaar zijn in DisplayFormat:

  • De browser kan HTML5-functies inschakelen. U kunt bijvoorbeeld een agendabesturingselement, het valutasymbool, e-mailkoppelingen en invoervalidatie aan de clientzijde weergeven.
  • De browser geeft standaard gegevens weer met de juiste indeling op basis van de landinstelling.

Zie de documentatie over de <invoertag> Tag Helper voor meer informatie.

Het kenmerk StringLength

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]

Regels voor gegevensvalidatie en validatiefoutberichten kunnen worden opgegeven met kenmerken. Het kenmerk StringLength specificeert de minimale en maximale lengte van tekens die zijn toegestaan in een gegevensveld. De weergegeven code beperkt namen tot maximaal 50 tekens. Een voorbeeld waarmee de minimale tekenreekslengte wordt ingesteld, wordt later weergegeven.

Het StringLength kenmerk biedt ook validatie aan clientzijde en serverzijde. De minimale waarde heeft geen invloed op het databaseschema.

Het StringLength kenmerk voorkomt niet dat een gebruiker witruimte invoert voor een naam. Het kenmerk RegularExpression kan worden gebruikt om beperkingen toe te passen op de invoer. Voor de volgende code moet het eerste teken bijvoorbeeld hoofdletters en de resterende tekens alfabetisch zijn:

[RegularExpression(@"^[A-Z]+[a-zA-Z]*$")]

Open in SQL Server Objectverkenner (SSOX) de ontwerpfunctie voor studententabellen door te dubbelklikken op de tabel Student .

Tabel Studenten in SSOX vóór migraties

In de voorgaande afbeelding ziet u het schema voor de Student tabel. De naamvelden hebben het type nvarchar(MAX). Wanneer een migratie wordt gemaakt en later in deze tutorial wordt uitgevoerd, worden de naamvelden nvarchar(50) als gevolg van de lengtekenmerken van de tekenreeks.

Het kenmerk Kolom

[Column("FirstName")]
public string FirstMidName { get; set; }

Kenmerken kunnen bepalen hoe klassen en eigenschappen worden toegewezen aan de database. In het Student model wordt het Column kenmerk gebruikt om de naam van de FirstMidName eigenschap toe te wijzen aan FirstName in de database.

Wanneer de database wordt gemaakt, worden eigenschapsnamen in het model gebruikt voor kolomnamen (behalve wanneer het Column kenmerk wordt gebruikt). Het Student model gebruikt FirstMidName voor het veld voor de voornaam, omdat het veld mogelijk ook een middelste naam bevat.

Met het [Column] kenmerk wordt Student.FirstMidName in het gegevensmodel toegewezen aan de FirstName kolom van de Student tabel. Door het toevoegen van het Column kenmerk verandert het achterliggende model van de SchoolContext. Het model achter de SchoolContext komt niet langer overeen met de database. Deze discrepantie wordt opgelost door later in deze zelfstudie een migratie toe te voegen.

Het Vereiste kenmerk

[Required]

Het Required kenmerk maakt de naamkenmerken verplichte velden. Het Required kenmerk is niet nodig voor niet-null-typen, zoals waardetypen (bijvoorbeeld DateTime, inten double). Typen die niet null kunnen zijn, worden automatisch behandeld als vereiste velden.

Het kenmerk Required moet samen met MinimumLength worden gebruikt om MinimumLength te handhaven.

[Display(Name = "Last Name")]
[Required]
[StringLength(50, MinimumLength=2)]
public string LastName { get; set; }

MinimumLength en Required witruimte toestaan om te voldoen aan de validatie. Gebruik het RegularExpression kenmerk voor volledige controle over de tekenreeks.

Het kenmerk Weergave

[Display(Name = "Last Name")]

Het Display kenmerk geeft aan dat het bijschrift voor de tekstvakken 'Voornaam', 'Achternaam', 'Volledige naam' en 'Inschrijvingsdatum' moet zijn. De standaardbijschriften hadden geen spatie tussen de woorden, bijvoorbeeld 'Achternaam'.

Een migratie maken

Voer de app uit en ga naar de pagina Leerlingen/studenten. Er wordt een uitzondering gegenereerd. Het [Column] kenmerk zorgt ervoor dat EF verwacht een kolom met de naam FirstNamete vinden, maar de kolomnaam in de database is nog steeds FirstMidName.

Het foutbericht is vergelijkbaar met het volgende voorbeeld:

SqlException: Invalid column name 'FirstName'.
There are pending model changes
Pending model changes are detected in the following:

SchoolContext
  • Voer in de PMC de volgende opdrachten in om een nieuwe migratie te maken en de database bij te werken:

    Add-Migration ColumnFirstName
    Update-Database
    
    

    Met de eerste van deze opdrachten wordt het volgende waarschuwingsbericht gegenereerd:

    An operation was scaffolded that may result in the loss of data.
    Please review the migration for accuracy.
    

    De waarschuwing wordt gegenereerd omdat de naamvelden nu beperkt zijn tot 50 tekens. Als een naam in de database meer dan 50 tekens heeft, gaat het laatste teken verloren.

  • Open de tabel Student in SSOX:

    Studenten tabel in SSOX na migraties

    Voordat de migratie werd toegepast, waren de naamkolommen van het type nvarchar(MAX). De naamkolommen zijn nu nvarchar(50). De kolomnaam is gewijzigd van FirstMidName in FirstName.

  • Voer de app uit en ga naar de pagina Leerlingen/studenten.
  • U ziet dat tijden niet worden ingevoerd of samen met datums worden weergegeven.
  • Selecteer Nieuw maken en voer een naam in die langer is dan 50 tekens.

Opmerking

In de volgende secties genereert het bouwen van de app in sommige fasen compilerfouten. De instructies geven aan wanneer de app moet worden gebouwd.

De entiteit Docent

Maak Models/Instructor.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Instructor
    {
        public int ID { get; set; }

        [Required]
        [Display(Name = "Last Name")]
        [StringLength(50)]
        public string LastName { get; set; }

        [Required]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        [StringLength(50)]
        public string FirstMidName { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Hire Date")]
        public DateTime HireDate { get; set; }

        [Display(Name = "Full Name")]
        public string FullName
        {
            get { return LastName + ", " + FirstMidName; }
        }

        public ICollection<Course> Courses { get; set; }
        public OfficeAssignment OfficeAssignment { get; set; }
    }
}

Meerdere kenmerken kunnen op één regel staan. De HireDate kenmerken kunnen als volgt worden geschreven:

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

De Courses eigenschappen en OfficeAssignment eigenschappen zijn navigatie-eigenschappen.

Een docent kan een willekeurig aantal cursussen leren, dus Courses wordt gedefinieerd als een verzameling.

public ICollection<Course> Courses { get; set; }

Een docent kan maximaal één kantoor hebben, dus de OfficeAssignment eigenschap heeft één OfficeAssignment entiteit. OfficeAssignment is null als er geen kantoor is toegewezen.

public OfficeAssignment OfficeAssignment { get; set; }

De OfficeAssignment-entiteit

OfficeAssignment-entiteit

Maak Models/OfficeAssignment.cs met de volgende code:

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class OfficeAssignment
    {
        [Key]
        public int InstructorID { get; set; }
        [StringLength(50)]
        [Display(Name = "Office Location")]
        public string Location { get; set; }

        public Instructor Instructor { get; set; }
    }
}

Het Sleutelkenmerk

Het [Key] kenmerk wordt gebruikt om een eigenschap te identificeren als de primaire sleutel (PK) wanneer de naam van de eigenschap iets anders is dan classnameID of ID.

Er is een een-op-nul-of-een-relatie tussen de Instructor en OfficeAssignment entiteiten. Er bestaat alleen een kantoortoewijzing met betrekking tot de docent waaraan deze is toegewezen. De OfficeAssignment PK is ook de vreemde sleutel (FK) voor de Instructor entiteit. Een een-op-nul-of-een-relatie komt voor wanneer een PK in de ene tabel zowel een PK als een FK in een andere tabel is.

EF Core kan InstructorID niet automatisch als de PK van OfficeAssignment herkennen, omdat InstructorID de ID- of klassenaamID-naamconventie niet volgt. Daarom wordt het Key kenmerk gebruikt om te identificeren InstructorID als pk:

[Key]
public int InstructorID { get; set; }

De sleutel wordt standaard behandeld als niet-database-gegenereerd door EF Core omdat de kolom bedoeld is voor een identificatierelatie. Zie EF-sleutels voor meer informatie.

De navigatie-eigenschap Instructeur

De Instructor.OfficeAssignment navigatie-eigenschap kan null zijn omdat er mogelijk geen OfficeAssignment rij is voor een bepaalde docent. Een docent heeft mogelijk geen kantooropdracht.

De OfficeAssignment.Instructor navigatie-eigenschap heeft altijd een entiteit docent omdat het type refererende sleutel InstructorID een niet-null-waardetype is int. Een kantooropdracht kan niet bestaan zonder docent.

Wanneer een Instructor entiteit een gerelateerde OfficeAssignment entiteit heeft, heeft elke entiteit een verwijzing naar de andere entiteit in de navigatie-eigenschap.

Cursusentiteit

Werk Models/Course.cs bij met de volgende code:

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Course
    {
        [DatabaseGenerated(DatabaseGeneratedOption.None)]
        [Display(Name = "Number")]
        public int CourseID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Title { get; set; }

        [Range(0, 5)]
        public int Credits { get; set; }

        public int DepartmentID { get; set; }

        public Department Department { get; set; }
        public ICollection<Enrollment> Enrollments { get; set; }
        public ICollection<Instructor> Instructors { get; set; }
    }
}

De Course entiteit heeft een buitenlandse sleutel (FK) eigenschap DepartmentID. DepartmentID verwijst naar de gerelateerde Department entiteit. De Course entiteit heeft een Department navigatie-eigenschap.

EF Core vereist geen vreemde-sleuteleigenschap in een datamodel wanneer het model een navigatie-eigenschap heeft voor een gerelateerde entiteit. EF Core maakt automatisch FK's in de database waar ze nodig zijn. EF Core maakt schaduweigenschappen voor automatisch gemaakte FK's. Het expliciet opnemen van de FK in het gegevensmodel kan updates echter eenvoudiger en efficiënter maken. Denk bijvoorbeeld aan een model waarin de FK-eigenschap DepartmentIDniet is opgenomen. Wanneer een cursusentiteit wordt opgehaald om te bewerken:

  • De Department eigenschap is null als deze niet expliciet wordt geladen.
  • Als u de cursusentiteit wilt bijwerken, moet de Department entiteit eerst worden opgehaald.

Wanneer de FK-eigenschap DepartmentID is opgenomen in het gegevensmodel, hoeft u de Department entiteit niet op te halen vóór een update.

Het kenmerk DatabaseGenerated

Het [DatabaseGenerated(DatabaseGeneratedOption.None)] kenmerk geeft aan dat de PK wordt geleverd door de toepassing in plaats van gegenereerd door de database.

[DatabaseGenerated(DatabaseGeneratedOption.None)]
[Display(Name = "Number")]
public int CourseID { get; set; }

EF Core Standaard wordt ervan uitgegaan dat PK-waarden worden gegenereerd door de database. Database-gegenereerd is over het algemeen de beste benadering. Voor Course entiteiten geeft de gebruiker de PK op. Bijvoorbeeld een cursusnummer, zoals een 1000-serie voor de wiskundeafdeling, een serie van 2000 voor de Engelse afdeling.

Het DatabaseGenerated kenmerk kan ook worden gebruikt om standaardwaarden te genereren. De database kan bijvoorbeeld automatisch een datumveld genereren om de datum vast te leggen waarop een rij is gemaakt of bijgewerkt. Zie Gegenereerde eigenschappen voor meer informatie.

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De sleuteleigenschappen en navigatie-eigenschappen van de vreemde sleutel (FK) in de Course-entiteit weerspiegelen de volgende relaties:

Er wordt een cursus toegewezen aan één afdeling, dus er is een DepartmentID FK en een Department navigatie-eigenschap.

public int DepartmentID { get; set; }
public Department Department { get; set; }

Een cursus kan een willekeurig aantal leerlingen/studenten hebben ingeschreven, zodat de Enrollments navigatie-eigenschap een verzameling is:

public ICollection<Enrollment> Enrollments { get; set; }

Een cursus kan worden gegeven door meerdere instructeurs, dus de Instructors navigatie-eigenschap is een verzameling:

public ICollection<Instructor> Instructors { get; set; }

De Afdeling-entiteit

Maak Models/Department.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Department
    {
        public int DepartmentID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Name { get; set; }

        [DataType(DataType.Currency)]
        [Column(TypeName = "money")]
        public decimal Budget { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}",
                       ApplyFormatInEditMode = true)]
        [Display(Name = "Start Date")]
        public DateTime StartDate { get; set; }

        public int? InstructorID { get; set; }

        public Instructor Administrator { get; set; }
        public ICollection<Course> Courses { get; set; }
    }
}

Het kenmerk Kolom

Voorheen werd het Column kenmerk gebruikt om de kolomnaamtoewijzing te wijzigen. In de code voor de Department entiteit wordt het Column kenmerk gebruikt om de toewijzing van het SQL-gegevenstype te wijzigen. De Budget kolom wordt gedefinieerd met behulp van het geldtype SQL Server in de database:

[Column(TypeName="money")]
public decimal Budget { get; set; }

Kolomtoewijzing is over het algemeen niet vereist. EF Core kiest het juiste SQL Server-gegevenstype op basis van het CLR-type voor de eigenschap. Het CLR-type decimal wordt toegewezen aan een SQL Server-type decimal . Budget is voor valuta en het gegevenstype geld is geschikter voor valuta.

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De FK- en navigatie-eigenschappen weerspiegelen de volgende relaties:

  • Een afdeling heeft al dan niet een beheerder.
  • Een beheerder is altijd een instructeur. Daarom is de InstructorID eigenschap opgenomen als de FK voor de Instructor entiteit.

De navigatie-eigenschap heeft een naam Administrator , maar bevat een Instructor entiteit:

public int? InstructorID { get; set; }
public Instructor Administrator { get; set; }

De ? in de voorgaande code geeft aan dat de eigenschap nullable is.

Een afdeling kan veel cursussen hebben, daarom is er een navigatie-eigenschap genaamd Cursussen.

public ICollection<Course> Courses { get; set; }

Volgens conventie kunt u met EF Core cascade delete inschakelen voor niet-nulbare FKs en voor veel-op-veel relaties. Dit standaardgedrag kan leiden tot regels voor trapsgewijs verwijderen. Regels voor circulair trapsgewijs verwijderen veroorzaken een foutmelding wanneer een migratie wordt toegevoegd.

Als de Department.InstructorID eigenschap bijvoorbeeld is gedefinieerd als niet-nullable, zou EF Core een cascadeverwijderingsregel configureren. In dat geval wordt de afdeling verwijderd wanneer de docent die als beheerder is toegewezen, wordt verwijderd. In dit scenario zou een beperkingsregel logischer zijn. Met de volgende Fluent API wordt er een restrictieregel ingesteld en de cascading delete functie uitgeschakeld.

modelBuilder.Entity<Department>()
   .HasOne(d => d.Administrator)
   .WithMany()
   .OnDelete(DeleteBehavior.Restrict)

De vreemde sleutel en navigatie-eigenschappen van de inschrijving

Een inschrijvingsrecord is voor één cursus die door één student wordt gevolgd.

Inschrijvingsentiteit

Werk Models/Enrollment.cs bij met de volgende code:

using System.ComponentModel.DataAnnotations;

namespace ContosoUniversity.Models
{
    public enum Grade
    {
        A, B, C, D, F
    }

    public class Enrollment
    {
        public int EnrollmentID { get; set; }
        public int CourseID { get; set; }
        public int StudentID { get; set; }
        [DisplayFormat(NullDisplayText = "No grade")]
        public Grade? Grade { get; set; }

        public Course Course { get; set; }
        public Student Student { get; set; }
    }
}

De FK-eigenschappen en navigatie-eigenschappen weerspiegelen de volgende relaties:

Een inschrijvingsrecord is voor één cursus, dus er is een CourseID FK-eigenschap en een Course navigatie-eigenschap:

public int CourseID { get; set; }
public Course Course { get; set; }

Een inschrijvingsrecord is voor één student, dus er is een StudentID FK-eigenschap en een Student navigatie-eigenschap:

public int StudentID { get; set; }
public Student Student { get; set; }

Veel-op-veel-relaties

Er bestaat een veel-op-veelrelatie tussen de Student- en Course-entiteiten. De Enrollment entiteit fungeert als een many-to-many-join-tabel met payload in de database. Met payload betekent dit dat de Enrollment tabel naast FK's voor de gekoppelde tabellen aanvullende gegevens bevat. In de Enrollment entiteit zijn de aanvullende gegevens naast FK's de PK en Grade.

In de volgende afbeelding ziet u hoe deze relaties eruitzien in een entiteitsdiagram. (Dit diagram is gegenereerd met EF Power Tools voor EF 6.x. Het maken van het diagram maakt geen deel uit van de zelfstudie.)

Student-Course veel-op-veel-relatie

Elke relatielijn heeft een 1 aan het ene uiteinde en een sterretje (*) aan de andere, wat een een-op-veel-relatie aangeeft.

Als de Enrollment tabel geen cijfergegevens bevat, hoeft deze alleen de twee FK's te bevatten en CourseIDStudentID. Een veel-op-veel-join-tabel zonder inhoud wordt soms een pure join-tabel (PJT) genoemd.

De Instructor en Course entiteiten hebben een veel-op-veel-relatie met behulp van een PJT.

De databasecontext bijwerken

Werk Data/SchoolContext.cs bij met de volgende code:

using ContosoUniversity.Models;
using Microsoft.EntityFrameworkCore;

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

        public DbSet<Course> Courses { get; set; }
        public DbSet<Enrollment> Enrollments { get; set; }
        public DbSet<Student> Students { get; set; }
        public DbSet<Department> Departments { get; set; }
        public DbSet<Instructor> Instructors { get; set; }
        public DbSet<OfficeAssignment> OfficeAssignments { get; set; }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Course>().ToTable(nameof(Course))
                .HasMany(c => c.Instructors)
                .WithMany(i => i.Courses);
            modelBuilder.Entity<Student>().ToTable(nameof(Student));
            modelBuilder.Entity<Enrollment>().ToTable("Enrollment");
            modelBuilder.Entity<Instructor>().ToTable(nameof(Instructor));
        }
    }
}

Met de voorgaande code worden de nieuwe entiteiten toegevoegd en wordt de veel-op-veel-relatie tussen de Instructor en Course entiteiten geconfigureerd.

Fluent-API-alternatief voor kenmerken

De OnModelCreating methode in de voorgaande code maakt gebruik van de Fluent-API om gedrag te configureren EF Core . De API wordt 'fluent' genoemd, omdat deze vaak wordt gebruikt door een reeks methode-aanroepen samen te voegen in één instructie. De volgende code is een voorbeeld van de fluent-API:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.Url)
        .IsRequired();
}

In deze zelfstudie wordt de Fluent API alleen gebruikt voor database-mapping die niet kan worden uitgevoerd met attributen. De fluent-API kan echter de meeste opmaak-, validatie- en toewijzingsregels opgeven die kunnen worden uitgevoerd met kenmerken.

Sommige kenmerken, zoals MinimumLength kunnen niet worden toegepast met de fluent-API. MinimumLength wijzigt het schema niet, er wordt alleen een validatieregel voor minimale lengte toegepast.

Sommige ontwikkelaars gebruiken de fluent-API liever uitsluitend, zodat ze hun entiteitsklassen schoon kunnen houden. Attributen en de fluent API kunnen worden gecombineerd. Er zijn enkele configuraties die alleen kunnen worden uitgevoerd met de fluent-API, bijvoorbeeld door een samengestelde PK op te geven. Er zijn enkele configuraties die alleen kunnen worden uitgevoerd met kenmerken (MinimumLength). De aanbevolen procedure voor het gebruik van fluent API of attributen:

  • Kies een van deze twee benaderingen.
  • Gebruik de gekozen benadering consistent zo veel mogelijk.

Enkele van de in deze zelfstudie gebruikte kenmerken zijn bedoeld voor:

  • Alleen validatie (bijvoorbeeld MinimumLength).
  • EF Core alleen configuratie (bijvoorbeeld HasKey).
  • Validatie en EF Core configuratie (bijvoorbeeld [StringLength(50)]).

Zie Methoden voor configuratie voor meer informatie over kenmerken versus fluent API.

De database vullen met gegevens

Werk de code bij in Data/DbInitializer.cs:

using ContosoUniversity.Models;
using System;
using System.Collections.Generic;
using System.Linq;

namespace ContosoUniversity.Data
{
    public static class DbInitializer
    {
        public static void Initialize(SchoolContext context)
        {
            // Look for any students.
            if (context.Students.Any())
            {
                return;   // DB has been seeded
            }

            var alexander = new Student
            {
                FirstMidName = "Carson",
                LastName = "Alexander",
                EnrollmentDate = DateTime.Parse("2016-09-01")
            };

            var alonso = new Student
            {
                FirstMidName = "Meredith",
                LastName = "Alonso",
                EnrollmentDate = DateTime.Parse("2018-09-01")
            };

            var anand = new Student
            {
                FirstMidName = "Arturo",
                LastName = "Anand",
                EnrollmentDate = DateTime.Parse("2019-09-01")
            };

            var barzdukas = new Student
            {
                FirstMidName = "Gytis",
                LastName = "Barzdukas",
                EnrollmentDate = DateTime.Parse("2018-09-01")
            };

            var li = new Student
            {
                FirstMidName = "Yan",
                LastName = "Li",
                EnrollmentDate = DateTime.Parse("2018-09-01")
            };

            var justice = new Student
            {
                FirstMidName = "Peggy",
                LastName = "Justice",
                EnrollmentDate = DateTime.Parse("2017-09-01")
            };

            var norman = new Student
            {
                FirstMidName = "Laura",
                LastName = "Norman",
                EnrollmentDate = DateTime.Parse("2019-09-01")
            };

            var olivetto = new Student
            {
                FirstMidName = "Nino",
                LastName = "Olivetto",
                EnrollmentDate = DateTime.Parse("2011-09-01")
            };

            var students = new Student[]
            {
                alexander,
                alonso,
                anand,
                barzdukas,
                li,
                justice,
                norman,
                olivetto
            };

            context.AddRange(students);

            var abercrombie = new Instructor
            {
                FirstMidName = "Kim",
                LastName = "Abercrombie",
                HireDate = DateTime.Parse("1995-03-11")
            };

            var fakhouri = new Instructor
            {
                FirstMidName = "Fadi",
                LastName = "Fakhouri",
                HireDate = DateTime.Parse("2002-07-06")
            };

            var harui = new Instructor
            {
                FirstMidName = "Roger",
                LastName = "Harui",
                HireDate = DateTime.Parse("1998-07-01")
            };

            var kapoor = new Instructor
            {
                FirstMidName = "Candace",
                LastName = "Kapoor",
                HireDate = DateTime.Parse("2001-01-15")
            };

            var zheng = new Instructor
            {
                FirstMidName = "Roger",
                LastName = "Zheng",
                HireDate = DateTime.Parse("2004-02-12")
            };

            var instructors = new Instructor[]
            {
                abercrombie,
                fakhouri,
                harui,
                kapoor,
                zheng
            };

            context.AddRange(instructors);

            var officeAssignments = new OfficeAssignment[]
            {
                new OfficeAssignment {
                    Instructor = fakhouri,
                    Location = "Smith 17" },
                new OfficeAssignment {
                    Instructor = harui,
                    Location = "Gowan 27" },
                new OfficeAssignment {
                    Instructor = kapoor,
                    Location = "Thompson 304" }
            };

            context.AddRange(officeAssignments);

            var english = new Department
            {
                Name = "English",
                Budget = 350000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = abercrombie
            };

            var mathematics = new Department
            {
                Name = "Mathematics",
                Budget = 100000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = fakhouri
            };

            var engineering = new Department
            {
                Name = "Engineering",
                Budget = 350000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = harui
            };

            var economics = new Department
            {
                Name = "Economics",
                Budget = 100000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = kapoor
            };

            var departments = new Department[]
            {
                english,
                mathematics,
                engineering,
                economics
            };

            context.AddRange(departments);

            var chemistry = new Course
            {
                CourseID = 1050,
                Title = "Chemistry",
                Credits = 3,
                Department = engineering,
                Instructors = new List<Instructor> { kapoor, harui }
            };

            var microeconomics = new Course
            {
                CourseID = 4022,
                Title = "Microeconomics",
                Credits = 3,
                Department = economics,
                Instructors = new List<Instructor> { zheng }
            };

            var macroeconmics = new Course
            {
                CourseID = 4041,
                Title = "Macroeconomics",
                Credits = 3,
                Department = economics,
                Instructors = new List<Instructor> { zheng }
            };

            var calculus = new Course
            {
                CourseID = 1045,
                Title = "Calculus",
                Credits = 4,
                Department = mathematics,
                Instructors = new List<Instructor> { fakhouri }
            };

            var trigonometry = new Course
            {
                CourseID = 3141,
                Title = "Trigonometry",
                Credits = 4,
                Department = mathematics,
                Instructors = new List<Instructor> { harui }
            };

            var composition = new Course
            {
                CourseID = 2021,
                Title = "Composition",
                Credits = 3,
                Department = english,
                Instructors = new List<Instructor> { abercrombie }
            };

            var literature = new Course
            {
                CourseID = 2042,
                Title = "Literature",
                Credits = 4,
                Department = english,
                Instructors = new List<Instructor> { abercrombie }
            };

            var courses = new Course[]
            {
                chemistry,
                microeconomics,
                macroeconmics,
                calculus,
                trigonometry,
                composition,
                literature
            };

            context.AddRange(courses);

            var enrollments = new Enrollment[]
            {
                new Enrollment {
                    Student = alexander,
                    Course = chemistry,
                    Grade = Grade.A
                },
                new Enrollment {
                    Student = alexander,
                    Course = microeconomics,
                    Grade = Grade.C
                },
                new Enrollment {
                    Student = alexander,
                    Course = macroeconmics,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = alonso,
                    Course = calculus,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = alonso,
                    Course = trigonometry,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = alonso,
                    Course = composition,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = anand,
                    Course = chemistry
                },
                new Enrollment {
                    Student = anand,
                    Course = microeconomics,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = barzdukas,
                    Course = chemistry,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = li,
                    Course = composition,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = justice,
                    Course = literature,
                    Grade = Grade.B
                }
            };

            context.AddRange(enrollments);
            context.SaveChanges();
        }
    }
}

De code hierboven bevat noopgegevens voor de nieuwe entiteiten. Met de meeste code worden nieuwe entiteitsobjecten gemaakt en voorbeeldgegevens geladen. De voorbeeldgegevens worden gebruikt voor het testen.

De migratie toepassen of verwijderen en opnieuw maken

Met de bestaande database zijn er twee manieren om de database te wijzigen:

Beide opties werken voor SQL Server. Hoewel de methode apply-migration complexer en tijdrovender is, is dit de voorkeursbenadering voor echte productieomgevingen.

De database verwijderen en opnieuw maken

Als u wilt afdwingen EF Core dat u een nieuwe database maakt, moet u de database verwijderen en bijwerken:

  • Verwijder de directory Migraties.
  • Voer in de Pakketbeheer Console (PMC) de volgende opdrachten uit:
Drop-Database
Add-Migration InitialCreate
Update-Database

Voer de app uit. Als u de app uitvoert, wordt de DbInitializer.Initialize methode uitgevoerd. DbInitializer.Initialize vult de nieuwe database.

Open de database in SSOX:

  • Als SSOX eerder is geopend, klikt u op de knop Vernieuwen .
  • Vouw het knooppunt Tabellen uit. De gemaakte tabellen worden weergegeven.

Volgende stappen

In de volgende twee zelfstudies ziet u hoe u gerelateerde gegevens leest en bijwerkt.

De vorige zelfstudies werkten met een basisgegevensmodel dat bestaat uit drie entiteiten. In deze handleiding:

  • Er worden meer entiteiten en relaties toegevoegd.
  • Het gegevensmodel wordt aangepast door opmaak, validatie en databasetoewijzingsregels op te geven.

Het voltooide gegevensmodel wordt weergegeven in de volgende afbeelding:

Entiteitsdiagram

De entiteit Student

Studententiteit

Vervang de code in Models/Student.cs door de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        [Required]
        [StringLength(50)]
        [Display(Name = "Last Name")]
        public string LastName { get; set; }
        [Required]
        [StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Enrollment Date")]
        public DateTime EnrollmentDate { get; set; }
        [Display(Name = "Full Name")]
        public string FullName
        {
            get
            {
                return LastName + ", " + FirstMidName;
            }
        }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

Met de voorgaande code wordt een FullName eigenschap toegevoegd en worden de volgende kenmerken toegevoegd aan bestaande eigenschappen:

  • [DataType]
  • [DisplayFormat]
  • [StringLength]
  • [Column]
  • [Required]
  • [Display]

De berekende eigenschap FullName

FullName is een berekende eigenschap die een waarde retourneert die wordt gemaakt door twee andere eigenschappen samen te voegen. FullName kan niet worden ingesteld, dus het heeft alleen een 'get'-toegangsmethode. Er wordt geen FullName kolom gemaakt in de database.

Het kenmerk DataType

[DataType(DataType.Date)]

Voor inschrijvingsdatums van leerlingen/studenten worden op alle pagina's het tijdstip van de dag weergegeven, samen met de datum, hoewel alleen de datum relevant is. Met behulp van kenmerken voor gegevensaantekening kunt u één codewijziging aanbrengen waarmee de weergave-indeling wordt hersteld op elke pagina waarin de gegevens worden weergegeven.

Het kenmerk DataType geeft een gegevenstype op dat specifieker is dan het intrinsieke databasetype. In dit geval moet alleen de datum worden weergegeven, niet de datum en tijd. De DataType Enumeratie biedt veel gegevenstypen, zoals Datum, Tijd, Telefoonnummer, Valuta, E-mailadres, enzovoort. Het kenmerk DataType kan de app ook in staat stellen automatisch functies te bieden die specifiek zijn voor het type. Voorbeeld:

  • De mailto: koppeling wordt automatisch gemaakt voor DataType.EmailAddress.
  • De datumkiezer is beschikbaar in DataType.Date de meeste browsers.

Het DataType kenmerk verzendt HTML 5 data--kenmerken (uitgesproken als data streepje). De DataType kenmerken bieden geen validatie.

Het kenmerk DisplayFormat

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

DataType.Date specificeert niet het formaat van de datum die wordt weergegeven. Standaard wordt het datumveld weergegeven volgens de standaardindelingen op basis van de CultureInfo van de server.

Het DisplayFormat kenmerk wordt gebruikt om expliciet de datumnotatie op te geven. De ApplyFormatInEditMode instelling geeft aan dat de opmaak ook moet worden toegepast op de gebruikersinterface voor bewerken. Sommige velden mogen niet worden gebruikt ApplyFormatInEditMode. Het valutasymbool moet in het algemeen niet worden weergegeven in een tekstvak voor bewerken.

Het DisplayFormat kenmerk kan op zichzelf worden gebruikt. Het is over het algemeen een goed idee om het DataType kenmerk te gebruiken met het DisplayFormat kenmerk. Het kenmerk DataType geeft de semantiek van de gegevens weer in plaats van hoe deze op een scherm worden weergegeven. Het DataType kenmerk biedt de volgende voordelen die niet beschikbaar zijn in DisplayFormat:

  • De browser kan HTML5-functies inschakelen. U kunt bijvoorbeeld een agendabesturingselement, het valutasymbool, e-mailkoppelingen en invoervalidatie aan de clientzijde weergeven.
  • De browser geeft standaard gegevens weer met de juiste indeling op basis van de landinstelling.

Zie de documentatie over de <invoertag> Tag Helper voor meer informatie.

Het kenmerk StringLength

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]

Regels voor gegevensvalidatie en validatiefoutberichten kunnen worden opgegeven met kenmerken. Het kenmerk StringLength specificeert de minimale en maximale lengte van tekens die zijn toegestaan in een gegevensveld. De weergegeven code beperkt namen tot maximaal 50 tekens. Een voorbeeld waarmee de minimale tekenreekslengte wordt ingesteld, wordt later weergegeven.

Het StringLength kenmerk biedt ook validatie aan clientzijde en serverzijde. De minimale waarde heeft geen invloed op het databaseschema.

Het StringLength kenmerk voorkomt niet dat een gebruiker witruimte invoert voor een naam. Het kenmerk RegularExpression kan worden gebruikt om beperkingen toe te passen op de invoer. Voor de volgende code moet het eerste teken bijvoorbeeld hoofdletters en de resterende tekens alfabetisch zijn:

[RegularExpression(@"^[A-Z]+[a-zA-Z]*$")]

Open in SQL Server Objectverkenner (SSOX) de ontwerpfunctie voor studententabellen door te dubbelklikken op de tabel Student .

Tabel Studenten in SSOX vóór migraties

In de voorgaande afbeelding ziet u het schema voor de Student tabel. De naamvelden hebben het type nvarchar(MAX). Wanneer een migratie wordt gemaakt en later in deze tutorial wordt uitgevoerd, worden de naamvelden nvarchar(50) als gevolg van de lengtekenmerken van de tekenreeks.

Het kenmerk Kolom

[Column("FirstName")]
public string FirstMidName { get; set; }

Kenmerken kunnen bepalen hoe klassen en eigenschappen worden toegewezen aan de database. In het Student model wordt het Column kenmerk gebruikt om de naam van de FirstMidName eigenschap toe te wijzen aan FirstName in de database.

Wanneer de database wordt gemaakt, worden eigenschapsnamen in het model gebruikt voor kolomnamen (behalve wanneer het Column kenmerk wordt gebruikt). Het Student model gebruikt FirstMidName voor het veld voor de voornaam, omdat het veld mogelijk ook een middelste naam bevat.

Met het [Column] kenmerk wordt Student.FirstMidName in het gegevensmodel toegewezen aan de FirstName kolom van de Student tabel. Door het toevoegen van het Column kenmerk verandert het achterliggende model van de SchoolContext. Het model achter de SchoolContext komt niet langer overeen met de database. Deze discrepantie wordt opgelost door later in deze zelfstudie een migratie toe te voegen.

Het Vereiste kenmerk

[Required]

Het Required kenmerk maakt de naamkenmerken verplichte velden. Het Required kenmerk is niet nodig voor niet-null-typen, zoals waardetypen (bijvoorbeeld DateTime, inten double). Typen die niet null kunnen zijn, worden automatisch behandeld als vereiste velden.

Het kenmerk Required moet samen met MinimumLength worden gebruikt om MinimumLength te handhaven.

[Display(Name = "Last Name")]
[Required]
[StringLength(50, MinimumLength=2)]
public string LastName { get; set; }

MinimumLength en Required witruimte toestaan om te voldoen aan de validatie. Gebruik het RegularExpression kenmerk voor volledige controle over de tekenreeks.

Het kenmerk Weergave

[Display(Name = "Last Name")]

Het Display kenmerk geeft aan dat het bijschrift voor de tekstvakken 'Voornaam', 'Achternaam', 'Volledige naam' en 'Inschrijvingsdatum' moet zijn. De standaardbijschriften hadden geen spatie tussen de woorden, bijvoorbeeld 'Achternaam'.

Een migratie maken

Voer de app uit en ga naar de pagina Leerlingen/studenten. Er wordt een uitzondering gegenereerd. Het [Column] kenmerk zorgt ervoor dat EF verwacht een kolom met de naam FirstNamete vinden, maar de kolomnaam in de database is nog steeds FirstMidName.

Het foutbericht is vergelijkbaar met het volgende voorbeeld:

SqlException: Invalid column name 'FirstName'.
  • Voer in de PMC de volgende opdrachten in om een nieuwe migratie te maken en de database bij te werken:

    Add-Migration ColumnFirstName
    Update-Database
    

    Met de eerste van deze opdrachten wordt het volgende waarschuwingsbericht gegenereerd:

    An operation was scaffolded that may result in the loss of data.
    Please review the migration for accuracy.
    

    De waarschuwing wordt gegenereerd omdat de naamvelden nu beperkt zijn tot 50 tekens. Als een naam in de database meer dan 50 tekens heeft, gaat het laatste teken verloren.

  • Open de tabel Student in SSOX:

    Studenten tabel in SSOX na migraties

    Voordat de migratie werd toegepast, waren de naamkolommen van het type nvarchar(MAX). De naamkolommen zijn nu nvarchar(50). De kolomnaam is gewijzigd van FirstMidName in FirstName.

  • Voer de app uit en ga naar de pagina Leerlingen/studenten.
  • U ziet dat tijden niet worden ingevoerd of samen met datums worden weergegeven.
  • Selecteer Nieuw maken en voer een naam in die langer is dan 50 tekens.

Opmerking

In de volgende secties genereert het bouwen van de app in sommige fasen compilerfouten. De instructies geven aan wanneer de app moet worden gebouwd.

De entiteit Docent

Entiteit Docent

Maak Models/Instructor.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Instructor
    {
        public int ID { get; set; }

        [Required]
        [Display(Name = "Last Name")]
        [StringLength(50)]
        public string LastName { get; set; }

        [Required]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        [StringLength(50)]
        public string FirstMidName { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Hire Date")]
        public DateTime HireDate { get; set; }

        [Display(Name = "Full Name")]
        public string FullName
        {
            get { return LastName + ", " + FirstMidName; }
        }

        public ICollection<CourseAssignment> CourseAssignments { get; set; }
        public OfficeAssignment OfficeAssignment { get; set; }
    }
}

Meerdere kenmerken kunnen op één regel staan. De HireDate kenmerken kunnen als volgt worden geschreven:

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

De CourseAssignments eigenschappen en OfficeAssignment eigenschappen zijn navigatie-eigenschappen.

Een docent kan een willekeurig aantal cursussen leren, dus CourseAssignments wordt gedefinieerd als een verzameling.

public ICollection<CourseAssignment> CourseAssignments { get; set; }

Een docent kan maximaal één kantoor hebben, dus de OfficeAssignment eigenschap heeft één OfficeAssignment entiteit. OfficeAssignment is null als er geen kantoor is toegewezen.

public OfficeAssignment OfficeAssignment { get; set; }

De OfficeAssignment-entiteit

OfficeAssignment-entiteit

Maak Models/OfficeAssignment.cs met de volgende code:

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class OfficeAssignment
    {
        [Key]
        public int InstructorID { get; set; }
        [StringLength(50)]
        [Display(Name = "Office Location")]
        public string Location { get; set; }

        public Instructor Instructor { get; set; }
    }
}

Het Sleutelkenmerk

Het [Key] kenmerk wordt gebruikt om een eigenschap te identificeren als de primaire sleutel (PK) wanneer de eigenschapsnaam iets anders is dan classnameID of id.

Er is een een-op-nul-of-een-relatie tussen de Instructor en OfficeAssignment entiteiten. Er bestaat alleen een kantoortoewijzing met betrekking tot de docent waaraan deze is toegewezen. De OfficeAssignment PK is ook de vreemde sleutel (FK) voor de Instructor entiteit.

EF Core kan InstructorID niet automatisch als de PK van OfficeAssignment herkennen, omdat InstructorID de ID- of klassenaamID-naamconventie niet volgt. Daarom wordt het Key kenmerk gebruikt om te identificeren InstructorID als pk:

[Key]
public int InstructorID { get; set; }

De sleutel wordt standaard behandeld als niet-database-gegenereerd door EF Core omdat de kolom bedoeld is voor een identificatierelatie.

De navigatie-eigenschap Instructeur

De Instructor.OfficeAssignment navigatie-eigenschap kan null zijn omdat er mogelijk geen OfficeAssignment rij is voor een bepaalde docent. Een docent heeft mogelijk geen kantooropdracht.

De OfficeAssignment.Instructor navigatie-eigenschap heeft altijd een entiteit docent omdat het type refererende sleutel InstructorID een niet-null-waardetype is int. Een kantooropdracht kan niet bestaan zonder docent.

Wanneer een Instructor entiteit een gerelateerde OfficeAssignment entiteit heeft, heeft elke entiteit een verwijzing naar de andere entiteit in de navigatie-eigenschap.

Cursusentiteit

Cursusentiteit

Werk Models/Course.cs bij met de volgende code:

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Course
    {
        [DatabaseGenerated(DatabaseGeneratedOption.None)]
        [Display(Name = "Number")]
        public int CourseID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Title { get; set; }

        [Range(0, 5)]
        public int Credits { get; set; }

        public int DepartmentID { get; set; }

        public Department Department { get; set; }
        public ICollection<Enrollment> Enrollments { get; set; }
        public ICollection<CourseAssignment> CourseAssignments { get; set; }
    }
}

De Course entiteit heeft een buitenlandse sleutel (FK) eigenschap DepartmentID. DepartmentID verwijst naar de gerelateerde Department entiteit. De Course entiteit heeft een Department navigatie-eigenschap.

EF Core vereist geen vreemde-sleuteleigenschap in een datamodel wanneer het model een navigatie-eigenschap heeft voor een gerelateerde entiteit. EF Core maakt automatisch FK's in de database waar ze nodig zijn. EF Core maakt schaduweigenschappen voor automatisch gemaakte FK's. Het expliciet opnemen van de FK in het gegevensmodel kan updates echter eenvoudiger en efficiënter maken. Denk bijvoorbeeld aan een model waarin de FK-eigenschap DepartmentIDniet is opgenomen. Wanneer een cursusentiteit wordt opgehaald om te bewerken:

  • De Department eigenschap is null als deze niet expliciet wordt geladen.
  • Als u de cursusentiteit wilt bijwerken, moet de Department entiteit eerst worden opgehaald.

Wanneer de FK-eigenschap DepartmentID is opgenomen in het gegevensmodel, hoeft u de Department entiteit niet op te halen vóór een update.

Het kenmerk DatabaseGenerated

Het [DatabaseGenerated(DatabaseGeneratedOption.None)] kenmerk geeft aan dat de PK wordt geleverd door de toepassing in plaats van gegenereerd door de database.

[DatabaseGenerated(DatabaseGeneratedOption.None)]
[Display(Name = "Number")]
public int CourseID { get; set; }

EF Core Standaard wordt ervan uitgegaan dat PK-waarden worden gegenereerd door de database. Database-gegenereerd is over het algemeen de beste benadering. Voor Course entiteiten geeft de gebruiker de PK op. Bijvoorbeeld een cursusnummer, zoals een 1000-serie voor de wiskundeafdeling, een serie van 2000 voor de Engelse afdeling.

Het DatabaseGenerated kenmerk kan ook worden gebruikt om standaardwaarden te genereren. De database kan bijvoorbeeld automatisch een datumveld genereren om de datum vast te leggen waarop een rij is gemaakt of bijgewerkt. Zie Gegenereerde eigenschappen voor meer informatie.

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De sleuteleigenschappen en navigatie-eigenschappen van de vreemde sleutel (FK) in de Course-entiteit weerspiegelen de volgende relaties:

Er wordt een cursus toegewezen aan één afdeling, dus er is een DepartmentID FK en een Department navigatie-eigenschap.

public int DepartmentID { get; set; }
public Department Department { get; set; }

Een cursus kan een willekeurig aantal leerlingen/studenten hebben ingeschreven, zodat de Enrollments navigatie-eigenschap een verzameling is:

public ICollection<Enrollment> Enrollments { get; set; }

Een cursus kan worden gegeven door meerdere instructeurs, dus de CourseAssignments navigatie-eigenschap is een verzameling:

public ICollection<CourseAssignment> CourseAssignments { get; set; }

CourseAssignment wordt later uitgelegd.

De Afdeling-entiteit

Afdelingsentiteit

Maak Models/Department.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Department
    {
        public int DepartmentID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Name { get; set; }

        [DataType(DataType.Currency)]
        [Column(TypeName = "money")]
        public decimal Budget { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Start Date")]
        public DateTime StartDate { get; set; }

        public int? InstructorID { get; set; }

        public Instructor Administrator { get; set; }
        public ICollection<Course> Courses { get; set; }
    }
}

Het kenmerk Kolom

Voorheen werd het Column kenmerk gebruikt om de kolomnaamtoewijzing te wijzigen. In de code voor de Department entiteit wordt het Column kenmerk gebruikt om de toewijzing van het SQL-gegevenstype te wijzigen. De Budget kolom wordt gedefinieerd met behulp van het geldtype SQL Server in de database:

[Column(TypeName="money")]
public decimal Budget { get; set; }

Kolomtoewijzing is over het algemeen niet vereist. EF Core kiest het juiste SQL Server-gegevenstype op basis van het CLR-type voor de eigenschap. Het CLR-type decimal wordt toegewezen aan een SQL Server-type decimal . Budget is voor valuta en het gegevenstype geld is geschikter voor valuta.

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De FK- en navigatie-eigenschappen weerspiegelen de volgende relaties:

  • Een afdeling heeft al dan niet een beheerder.
  • Een beheerder is altijd een instructeur. Daarom is de InstructorID eigenschap opgenomen als de FK voor de Instructor entiteit.

De navigatie-eigenschap heeft een naam Administrator , maar bevat een Instructor entiteit:

public int? InstructorID { get; set; }
public Instructor Administrator { get; set; }

Het vraagteken (?) in de voorgaande code geeft aan dat de eigenschap nullable is.

Een afdeling kan veel cursussen hebben, daarom is er een navigatie-eigenschap genaamd Cursussen.

public ICollection<Course> Courses { get; set; }

Volgens conventie kunt u met EF Core cascade delete inschakelen voor niet-nulbare FKs en voor veel-op-veel relaties. Dit standaardgedrag kan leiden tot regels voor trapsgewijs verwijderen. Regels voor circulair trapsgewijs verwijderen veroorzaken een foutmelding wanneer een migratie wordt toegevoegd.

Als de Department.InstructorID eigenschap bijvoorbeeld is gedefinieerd als niet-nullable, zou EF Core een cascadeverwijderingsregel configureren. In dat geval wordt de afdeling verwijderd wanneer de docent die als beheerder is toegewezen, wordt verwijderd. In dit scenario zou een beperkingsregel logischer zijn. Met de volgende Fluent API wordt er een restrictieregel ingesteld en de cascading delete functie uitgeschakeld.

modelBuilder.Entity<Department>()
   .HasOne(d => d.Administrator)
   .WithMany()
   .OnDelete(DeleteBehavior.Restrict)

De entiteit Inschrijving

Een inschrijvingsrecord is voor één cursus die door één student wordt gevolgd.

Inschrijvingsentiteit

Werk Models/Enrollment.cs bij met de volgende code:

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public enum Grade
    {
        A, B, C, D, F
    }

    public class Enrollment
    {
        public int EnrollmentID { get; set; }
        public int CourseID { get; set; }
        public int StudentID { get; set; }
        [DisplayFormat(NullDisplayText = "No grade")]
        public Grade? Grade { get; set; }

        public Course Course { get; set; }
        public Student Student { get; set; }
    }
}

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De FK-eigenschappen en navigatie-eigenschappen weerspiegelen de volgende relaties:

Een inschrijvingsrecord is voor één cursus, dus er is een CourseID FK-eigenschap en een Course navigatie-eigenschap:

public int CourseID { get; set; }
public Course Course { get; set; }

Een inschrijvingsrecord is voor één student, dus er is een StudentID FK-eigenschap en een Student navigatie-eigenschap:

public int StudentID { get; set; }
public Student Student { get; set; }

Veel-op-veel-relaties

Er bestaat een veel-op-veelrelatie tussen de Student- en Course-entiteiten. De Enrollment entiteit fungeert als een veel-op-veel-join-tabel met extra gegevens in de database. 'Met payload' betekent dat de Enrollment-tabel behalve FK's voor de verbonden tabellen aanvullende gegevens bevat (in dit geval de PK en Grade).

In de volgende afbeelding ziet u hoe deze relaties eruitzien in een entiteitsdiagram. (Dit diagram is gegenereerd met EF Power Tools voor EF 6.x. Het maken van het diagram maakt geen deel uit van de zelfstudie.)

Student-Course veel-op-veel-relatie

Elke relatielijn heeft een 1 aan het ene uiteinde en een sterretje (*) aan de andere, wat een een-op-veel-relatie aangeeft.

Als de Enrollment tabel geen cijfergegevens bevat, hoeft deze alleen de twee FK's (CourseID en StudentID) te bevatten. Een veel-op-veel-join-tabel zonder inhoud wordt soms een pure join-tabel (PJT) genoemd.

De Instructor en Course entiteiten hebben een veel-op-veel-relatie met behulp van een pure join-tabel.

Opmerking: EF 6.x ondersteunt impliciete jointabellen voor veel-op-veel-relaties, maar EF Core niet. Zie Veel-op-veel-relaties in EF Core 2.0 voor meer informatie.

De entiteit CourseAssignment

CourseAssignment-entiteit

Maak Models/CourseAssignment.cs met de volgende code:

namespace ContosoUniversity.Models
{
    public class CourseAssignment
    {
        public int InstructorID { get; set; }
        public int CourseID { get; set; }
        public Instructor Instructor { get; set; }
        public Course Course { get; set; }
    }
}

Voor de veel-op-veel-relatie tussen instructeur en cursussen is een koppeltabel vereist en de entiteit voor die koppeltabel is CourseAssignment.

Instructeur-naar-cursus m:M

Het is gebruikelijk om een join-entiteit EntityName1EntityName2een naam te geven. Als voorbeeld zou de join-tabel Instructor-to-Courses met dit patroon CourseInstructor zijn. We raden u echter aan een naam te gebruiken die de relatie beschrijft.

Gegevensmodellen beginnen eenvoudig en groeien. Join-tabellen zonder payload (PJT's) ontwikkelen zich regelmatig om een payload op te nemen. Wanneer u begint met een beschrijvende entiteitsnaam, hoeft de naam niet te worden gewijzigd wanneer de koppeltabel wordt gewijzigd. Idealiter heeft de join-entiteit een eigen natuurlijke naam (mogelijk één woord) in het bedrijfsdomein. Boeken en klanten kunnen bijvoorbeeld worden gekoppeld aan een koppelentiteit die Ratings heet. Voor de veel-op-veel-verbinding van instructeurs-cursussen heeft CourseAssignment de voorkeur boven CourseInstructor.

Samengestelde sleutel

De twee FK's in CourseAssignment (InstructorID en CourseID) identificeren elke rij van de CourseAssignment tabel uniek. CourseAssignment vereist geen toegewezen PK. De eigenschappen InstructorID en CourseID functioneren als een samengestelde PK. De enige manier om samengestelde SDK's op te EF Core geven, is met de fluent-API. In de volgende sectie ziet u hoe u de samengestelde PK configureert.

De samengestelde sleutel zorgt ervoor dat:

  • Meerdere rijen zijn toegestaan voor één cursus.
  • Meerdere rijen zijn toegestaan voor één docent.
  • Meerdere rijen zijn niet toegestaan voor dezelfde docent en cursus.

De Enrollment join-entiteit definieert een eigen PK, zodat duplicaten van dit type mogelijk zijn. Om dergelijke duplicaten te voorkomen:

  • Voeg een unieke index toe aan de FK-velden of
  • Configureren Enrollment met een primaire samengestelde sleutel die vergelijkbaar is met CourseAssignment. Zie Indexen voor meer informatie.

De databasecontext bijwerken

Werk Data/SchoolContext.cs bij met de volgende code:

using ContosoUniversity.Models;
using Microsoft.EntityFrameworkCore;

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

        public DbSet<Course> Courses { get; set; }
        public DbSet<Enrollment> Enrollments { get; set; }
        public DbSet<Student> Students { get; set; }
        public DbSet<Department> Departments { get; set; }
        public DbSet<Instructor> Instructors { get; set; }
        public DbSet<OfficeAssignment> OfficeAssignments { get; set; }
        public DbSet<CourseAssignment> CourseAssignments { get; set; }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Course>().ToTable("Course");
            modelBuilder.Entity<Enrollment>().ToTable("Enrollment");
            modelBuilder.Entity<Student>().ToTable("Student");
            modelBuilder.Entity<Department>().ToTable("Department");
            modelBuilder.Entity<Instructor>().ToTable("Instructor");
            modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment");
            modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment");

            modelBuilder.Entity<CourseAssignment>()
                .HasKey(c => new { c.CourseID, c.InstructorID });
        }
    }
}

De voorgaande code voegt de nieuwe entiteiten toe en configureert de samengestelde PK van de CourseAssignment entiteit.

Fluent-API-alternatief voor kenmerken

De OnModelCreating methode in de voorgaande code maakt gebruik van de Fluent-API om gedrag te configureren EF Core . De API wordt 'fluent' genoemd, omdat deze vaak wordt gebruikt door een reeks methode-aanroepen samen te voegen in één instructie. De volgende code is een voorbeeld van de fluent-API:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.Url)
        .IsRequired();
}

In deze zelfstudie wordt de Fluent API alleen gebruikt voor database-mapping die niet kan worden uitgevoerd met attributen. De fluent-API kan echter de meeste opmaak-, validatie- en toewijzingsregels opgeven die kunnen worden uitgevoerd met kenmerken.

Sommige kenmerken, zoals MinimumLength kunnen niet worden toegepast met de fluent-API. MinimumLength wijzigt het schema niet, er wordt alleen een validatieregel voor minimale lengte toegepast.

Sommige ontwikkelaars gebruiken de fluent API liever uitsluitend, zodat ze hun entiteitsklassen 'schoon' kunnen houden. Kenmerken en de fluent-API kunnen worden gemengd. Er zijn enkele configuraties die alleen kunnen worden uitgevoerd met de fluent-API (het opgeven van een samengestelde PK). Er zijn enkele configuraties die alleen kunnen worden uitgevoerd met kenmerken (MinimumLength). De aanbevolen procedure voor het gebruik van fluent API of attributen:

  • Kies een van deze twee benaderingen.
  • Gebruik de gekozen benadering consistent zo veel mogelijk.

Enkele van de in deze zelfstudie gebruikte kenmerken zijn bedoeld voor:

  • Alleen validatie (bijvoorbeeld MinimumLength).
  • EF Core alleen configuratie (bijvoorbeeld HasKey).
  • Validatie en EF Core configuratie (bijvoorbeeld [StringLength(50)]).

Zie Methoden voor configuratie voor meer informatie over kenmerken versus fluent API.

Entiteitsdiagram

In de volgende afbeelding ziet u het diagram dat EF Power Tools maakt voor het voltooide schoolmodel.

Entiteitsdiagram

In het voorgaande diagram ziet u:

  • Verschillende een-op-veel-relatielijnen (1 tot *).
  • De een-tot-nul-of-een-relatielijn (1 tot 0..1) tussen de Instructor en OfficeAssignment entiteiten.
  • De nul- of een-op-veel-relatielijn (0,.1 tot *) tussen de Instructor en Department entiteiten.

De database vullen met gegevens

Werk de code bij in Data/DbInitializer.cs:

using System;
using System.Linq;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using ContosoUniversity.Models;

namespace ContosoUniversity.Data
{
    public static class DbInitializer
    {
        public static void Initialize(SchoolContext context)
        {
            //context.Database.EnsureCreated();

            // Look for any students.
            if (context.Students.Any())
            {
                return;   // DB has been seeded
            }

            var students = new Student[]
            {
                new Student { FirstMidName = "Carson",   LastName = "Alexander",
                    EnrollmentDate = DateTime.Parse("2016-09-01") },
                new Student { FirstMidName = "Meredith", LastName = "Alonso",
                    EnrollmentDate = DateTime.Parse("2018-09-01") },
                new Student { FirstMidName = "Arturo",   LastName = "Anand",
                    EnrollmentDate = DateTime.Parse("2019-09-01") },
                new Student { FirstMidName = "Gytis",    LastName = "Barzdukas",
                    EnrollmentDate = DateTime.Parse("2018-09-01") },
                new Student { FirstMidName = "Yan",      LastName = "Li",
                    EnrollmentDate = DateTime.Parse("2018-09-01") },
                new Student { FirstMidName = "Peggy",    LastName = "Justice",
                    EnrollmentDate = DateTime.Parse("2017-09-01") },
                new Student { FirstMidName = "Laura",    LastName = "Norman",
                    EnrollmentDate = DateTime.Parse("2019-09-01") },
                new Student { FirstMidName = "Nino",     LastName = "Olivetto",
                    EnrollmentDate = DateTime.Parse("2011-09-01") }
            };

            context.Students.AddRange(students);
            context.SaveChanges();

            var instructors = new Instructor[]
            {
                new Instructor { FirstMidName = "Kim",     LastName = "Abercrombie",
                    HireDate = DateTime.Parse("1995-03-11") },
                new Instructor { FirstMidName = "Fadi",    LastName = "Fakhouri",
                    HireDate = DateTime.Parse("2002-07-06") },
                new Instructor { FirstMidName = "Roger",   LastName = "Harui",
                    HireDate = DateTime.Parse("1998-07-01") },
                new Instructor { FirstMidName = "Candace", LastName = "Kapoor",
                    HireDate = DateTime.Parse("2001-01-15") },
                new Instructor { FirstMidName = "Roger",   LastName = "Zheng",
                    HireDate = DateTime.Parse("2004-02-12") }
            };

            context.Instructors.AddRange(instructors);
            context.SaveChanges();

            var departments = new Department[]
            {
                new Department { Name = "English",     Budget = 350000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Abercrombie").ID },
                new Department { Name = "Mathematics", Budget = 100000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Fakhouri").ID },
                new Department { Name = "Engineering", Budget = 350000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Harui").ID },
                new Department { Name = "Economics",   Budget = 100000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Kapoor").ID }
            };

            context.Departments.AddRange(departments);
            context.SaveChanges();

            var courses = new Course[]
            {
                new Course {CourseID = 1050, Title = "Chemistry",      Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "Engineering").DepartmentID
                },
                new Course {CourseID = 4022, Title = "Microeconomics", Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "Economics").DepartmentID
                },
                new Course {CourseID = 4041, Title = "Macroeconomics", Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "Economics").DepartmentID
                },
                new Course {CourseID = 1045, Title = "Calculus",       Credits = 4,
                    DepartmentID = departments.Single( s => s.Name == "Mathematics").DepartmentID
                },
                new Course {CourseID = 3141, Title = "Trigonometry",   Credits = 4,
                    DepartmentID = departments.Single( s => s.Name == "Mathematics").DepartmentID
                },
                new Course {CourseID = 2021, Title = "Composition",    Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "English").DepartmentID
                },
                new Course {CourseID = 2042, Title = "Literature",     Credits = 4,
                    DepartmentID = departments.Single( s => s.Name == "English").DepartmentID
                },
            };

            context.Courses.AddRange(courses);
            context.SaveChanges();

            var officeAssignments = new OfficeAssignment[]
            {
                new OfficeAssignment {
                    InstructorID = instructors.Single( i => i.LastName == "Fakhouri").ID,
                    Location = "Smith 17" },
                new OfficeAssignment {
                    InstructorID = instructors.Single( i => i.LastName == "Harui").ID,
                    Location = "Gowan 27" },
                new OfficeAssignment {
                    InstructorID = instructors.Single( i => i.LastName == "Kapoor").ID,
                    Location = "Thompson 304" },
            };

            context.OfficeAssignments.AddRange(officeAssignments);
            context.SaveChanges();

            var courseInstructors = new CourseAssignment[]
            {
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Kapoor").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Harui").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Microeconomics" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Zheng").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Macroeconomics" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Zheng").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Calculus" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Fakhouri").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Trigonometry" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Harui").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Composition" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Abercrombie").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Literature" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Abercrombie").ID
                    },
            };

            context.CourseAssignments.AddRange(courseInstructors);
            context.SaveChanges();

            var enrollments = new Enrollment[]
            {
                new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alexander").ID,
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID,
                    Grade = Grade.A
                },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alexander").ID,
                    CourseID = courses.Single(c => c.Title == "Microeconomics" ).CourseID,
                    Grade = Grade.C
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alexander").ID,
                    CourseID = courses.Single(c => c.Title == "Macroeconomics" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                        StudentID = students.Single(s => s.LastName == "Alonso").ID,
                    CourseID = courses.Single(c => c.Title == "Calculus" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                        StudentID = students.Single(s => s.LastName == "Alonso").ID,
                    CourseID = courses.Single(c => c.Title == "Trigonometry" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alonso").ID,
                    CourseID = courses.Single(c => c.Title == "Composition" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Anand").ID,
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Anand").ID,
                    CourseID = courses.Single(c => c.Title == "Microeconomics").CourseID,
                    Grade = Grade.B
                    },
                new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Barzdukas").ID,
                    CourseID = courses.Single(c => c.Title == "Chemistry").CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Li").ID,
                    CourseID = courses.Single(c => c.Title == "Composition").CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Justice").ID,
                    CourseID = courses.Single(c => c.Title == "Literature").CourseID,
                    Grade = Grade.B
                    }
            };

            foreach (Enrollment e in enrollments)
            {
                var enrollmentInDataBase = context.Enrollments.Where(
                    s =>
                            s.Student.ID == e.StudentID &&
                            s.Course.CourseID == e.CourseID).SingleOrDefault();
                if (enrollmentInDataBase == null)
                {
                    context.Enrollments.Add(e);
                }
            }
            context.SaveChanges();
        }
    }
}

De code hierboven bevat noopgegevens voor de nieuwe entiteiten. Met de meeste code worden nieuwe entiteitsobjecten gemaakt en voorbeeldgegevens geladen. De voorbeeldgegevens worden gebruikt voor het testen. Bekijk Enrollments en CourseAssignments voor voorbeelden van hoeveel-op-veel-join-tabellen kunnen worden geseed.

Een migratie toevoegen

Bouw het project.

Voer in PMC de volgende opdracht uit.

Add-Migration ComplexDataModel

In de voorgaande opdracht wordt een waarschuwing weergegeven over mogelijk gegevensverlies.

An operation was scaffolded that may result in the loss of data.
Please review the migration for accuracy.
To undo this action, use 'ef migrations remove'

Als de database update opdracht wordt uitgevoerd, wordt de volgende fout gegenereerd:

The ALTER TABLE statement conflicted with the FOREIGN KEY constraint "FK_dbo.Course_dbo.Department_DepartmentID". The conflict occurred in
database "ContosoUniversity", table "dbo.Department", column 'DepartmentID'.

In de volgende sectie ziet u wat u moet doen met deze fout.

De migratie toepassen of verwijderen en opnieuw maken

Nu u een bestaande database hebt, moet u nadenken over het toepassen van wijzigingen. In deze zelfstudie ziet u twee alternatieven:

Beide opties werken voor SQL Server. Hoewel de methode apply-migration complexer en tijdrovender is, is dit de voorkeursbenadering voor echte productieomgevingen.

De database verwijderen en opnieuw maken

Sla deze sectie over als u SQL Server gebruikt en de benadering voor migratie toepassen wilt uitvoeren in de volgende sectie.

Als u wilt afdwingen EF Core dat u een nieuwe database maakt, moet u de database verwijderen en bijwerken:

  • Voer in de Pakketbeheer Console (PMC) de volgende opdracht uit:

    Drop-Database
    
  • Verwijder de map Migrations en voer vervolgens de volgende opdracht uit:

    Add-Migration InitialCreate
    Update-Database
    

Voer de app uit. Als u de app uitvoert, wordt de DbInitializer.Initialize methode uitgevoerd. DbInitializer.Initialize vult de nieuwe database.

Open de database in SSOX:

  • Als SSOX eerder is geopend, klikt u op de knop Vernieuwen .

  • Vouw het knooppunt Tabellen uit. De gemaakte tabellen worden weergegeven.

    Tabellen in SSOX

  • Bekijk de CourseAssignment tabel.

    • Klik met de rechtermuisknop op de tabel CourseAssignment en selecteer Gegevens weergeven.
    • Controleer of de tabel CourseAssignment gegevens bevat.

    CourseAssignment-gegevens in SSOX

De migratie toepassen

Deze sectie is optioneel. Deze stappen werken alleen voor SQL Server LocalDB en alleen als u de vorige sectie Verwijderen hebt overgeslagen en de databasesectie opnieuw hebt gemaakt.

Wanneer migraties worden uitgevoerd met bestaande gegevens, zijn er mogelijk FK-beperkingen die niet tevreden zijn met de bestaande gegevens. Met productiegegevens moeten stappen worden ondernomen om de bestaande gegevens te migreren. Deze sectie bevat een voorbeeld van het oplossen van FK-beperkingsschendingen. Breng deze codewijzigingen niet aan zonder een back-up. Breng deze codewijzigingen niet aan als u de voorgaande sectie Verwijderen hebt voltooid en de databasesectie opnieuw hebt gemaakt .

Het bestand {timestamp}_ComplexDataModel.cs bevat de volgende code:

migrationBuilder.AddColumn<int>(
    name: "DepartmentID",
    table: "Course",
    type: "int",
    nullable: false,
    defaultValue: 0);

Met de voorgaande code wordt een niet-nullable DepartmentID FK aan de Course tabel toegevoegd. De database uit de vorige zelfstudie bevat rijen in Course, zodat de tabel niet kan worden bijgewerkt door migraties.

Om de ComplexDataModel migratie te laten werken met bestaande gegevens:

  • Wijzig de code om de nieuwe kolom (DepartmentID) een standaardwaarde te geven.
  • Maak een nepafdeling met de naam Temp om te fungeren als de standaardafdeling.

De beperkingen voor vreemde sleutels oplossen

Werk de methode ComplexDataModel bij in de migratieklasse Up.

  • Open het bestand {timestamp}_ComplexDataModel.cs.
  • Markeer de coderegel waarmee de DepartmentID kolom wordt toegevoegd aan de Course tabel als commentaar.
migrationBuilder.AlterColumn<string>(
    name: "Title",
    table: "Course",
    maxLength: 50,
    nullable: true,
    oldClrType: typeof(string),
    oldNullable: true);
            
//migrationBuilder.AddColumn<int>(
//    name: "DepartmentID",
//    table: "Course",
//    nullable: false,
//    defaultValue: 0);

Voeg de volgende gemarkeerde code toe. De nieuwe code gaat na het .CreateTable( name: "Department" blok:

migrationBuilder.CreateTable(
    name: "Department",
    columns: table => new
    {
        DepartmentID = table.Column<int>(type: "int", nullable: false)
            .Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
        Budget = table.Column<decimal>(type: "money", nullable: false),
        InstructorID = table.Column<int>(type: "int", nullable: true),
        Name = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: true),
        StartDate = table.Column<DateTime>(type: "datetime2", nullable: false)
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_Department", x => x.DepartmentID);
        table.ForeignKey(
            name: "FK_Department_Instructor_InstructorID",
            column: x => x.InstructorID,
            principalTable: "Instructor",
            principalColumn: "ID",
            onDelete: ReferentialAction.Restrict);
    });

 migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, GETDATE())");
// Default value for FK points to department created above, with
// defaultValue changed to 1 in following AddColumn statement.

migrationBuilder.AddColumn<int>(
    name: "DepartmentID",
    table: "Course",
    nullable: false,
    defaultValue: 1);

Met de voorgaande wijzigingen zijn bestaande Course rijen gerelateerd aan de afdeling Temp nadat de ComplexDataModel.Up methode is uitgevoerd.

De manier waarop u de hier getoonde situatie kunt afhandelen, is vereenvoudigd voor deze zelfstudie. Een productie-app zou het volgende doen:

  • Voeg code of scripts toe om Department rijen en gerelateerde Course rijen toe te voegen aan de nieuwe Department rijen.
  • Gebruik niet de afdeling Temp of de standaardwaarde voor Course.DepartmentID.
  • Voer in de Pakketbeheer Console (PMC) de volgende opdracht uit:

    Update-Database
    

Omdat de DbInitializer.Initialize methode is ontworpen om alleen te werken met een lege database, gebruikt u SSOX om alle rijen in de tabellen Student en Cursus te verwijderen. (Cascade verwijderen zal de inschrijvingstabel beheren.)

Voer de app uit. Als u de app uitvoert, wordt de DbInitializer.Initialize methode uitgevoerd. DbInitializer.Initialize vult de nieuwe database.

Volgende stappen

In de volgende twee zelfstudies ziet u hoe u gerelateerde gegevens leest en bijwerkt.

De vorige zelfstudies werkten met een basisgegevensmodel dat bestaat uit drie entiteiten. In deze handleiding:

  • Er worden meer entiteiten en relaties toegevoegd.
  • Het gegevensmodel wordt aangepast door opmaak, validatie en databasetoewijzingsregels op te geven.

De entiteitsklassen voor het voltooide gegevensmodel worden weergegeven in de volgende afbeelding:

Entiteitsdiagram

Als u problemen ondervindt die u niet kunt oplossen, downloadt u de voltooide app.

Het gegevensmodel aanpassen met kenmerken

In deze sectie wordt het gegevensmodel aangepast met behulp van kenmerken.

Het kenmerk DataType

Op de pagina's van de studenten wordt momenteel het tijdstip van de inschrijving weergegeven. Normaal gesproken geven datumvelden alleen de datum en niet de tijd weer.

Werk Models/Student.cs bij met de volgende gemarkeerde code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        public string LastName { get; set; }
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        public DateTime EnrollmentDate { get; set; }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

Het kenmerk DataType geeft een gegevenstype op dat specifieker is dan het intrinsieke databasetype. In dit geval moet alleen de datum worden weergegeven, niet de datum en tijd. De DataType Enumeratie biedt veel gegevenstypen, zoals Datum, Tijd, Telefoonnummer, Valuta, E-mailadres, enzovoort. Het kenmerk DataType kan de app ook in staat stellen automatisch functies te bieden die specifiek zijn voor het type. Voorbeeld:

  • De mailto: koppeling wordt automatisch gemaakt voor DataType.EmailAddress.
  • De datumkiezer is beschikbaar in DataType.Date de meeste browsers.

Het DataType kenmerk genereert HTML 5-kenmerken data- (uitgesproken als data dash) die HTML 5-browsers gebruiken. De DataType kenmerken bieden geen validatie.

DataType.Date specificeert niet het formaat van de datum die wordt weergegeven. Standaard wordt het datumveld weergegeven volgens de standaardindelingen op basis van de CultureInfo van de server.

Het kenmerk DisplayFormat wordt gebruikt om expliciet de datumnotatie op te geven:

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

De ApplyFormatInEditMode instelling geeft aan dat de opmaak ook moet worden toegepast op de gebruikersinterface voor bewerken. Sommige velden mogen niet worden gebruikt ApplyFormatInEditMode. Het valutasymbool moet in het algemeen niet worden weergegeven in een tekstvak voor bewerken.

Het DisplayFormat kenmerk kan op zichzelf worden gebruikt. Het is over het algemeen een goed idee om het DataType kenmerk te gebruiken met het DisplayFormat kenmerk. Het kenmerk DataType geeft de semantiek van de gegevens weer in plaats van hoe deze op een scherm worden weergegeven. Het DataType kenmerk biedt de volgende voordelen die niet beschikbaar zijn in DisplayFormat:

  • De browser kan HTML5-functies inschakelen. U kunt bijvoorbeeld een agendabesturingselement weergeven, het valutasymbool dat geschikt is voor landinstellingen, e-mailkoppelingen, invoervalidatie aan de clientzijde, enzovoort.
  • De browser geeft standaard gegevens weer met de juiste indeling op basis van de landinstelling.

Zie de documentatie over de <invoertag> Tag Helper voor meer informatie.

Voer de app uit. Navigeer naar de pagina Studentenindex. Tijden worden niet meer weergegeven. Elke weergave die gebruikmaakt van het Student model geeft de datum zonder tijd weer.

Indexpagina studenten waarin datums zonder tijden worden getoond

Het kenmerk StringLength

Regels voor gegevensvalidatie en validatiefoutberichten kunnen worden opgegeven met kenmerken. Het kenmerk StringLength specificeert de minimale en maximale lengte van tekens die zijn toegestaan in een gegevensveld. Het StringLength kenmerk biedt ook validatie aan clientzijde en serverzijde. De minimale waarde heeft geen invloed op het databaseschema.

Werk het Student model bij met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        [StringLength(50)]
        public string LastName { get; set; }
        [StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        public DateTime EnrollmentDate { get; set; }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

De voorgaande code beperkt namen tot maximaal 50 tekens. Het StringLength kenmerk voorkomt niet dat een gebruiker witruimte invoert voor een naam. Het kenmerk RegularExpression wordt gebruikt om beperkingen toe te passen op de invoer. Voor de volgende code moet het eerste teken bijvoorbeeld hoofdletters en de resterende tekens alfabetisch zijn:

[RegularExpression(@"^[A-Z]+[a-zA-Z]*$")]

Voer de app uit:

  • Navigeer naar de pagina Leerlingen/studenten.
  • Selecteer Nieuw maken en voer een naam in die langer is dan 50 tekens.
  • Selecteer Maken, aan de clientzijde verschijnt er een foutmelding.

Indexpagina studenten waar lengtefouten in tekenreeksen worden weergegeven

Open in SQL Server Objectverkenner (SSOX) de ontwerpfunctie voor studententabellen door te dubbelklikken op de tabel Student .

Tabel Studenten in SSOX vóór migraties

In de voorgaande afbeelding ziet u het schema voor de Student tabel. De naamvelden hebben een type nvarchar(MAX) omdat migraties niet zijn uitgevoerd op de database. Wanneer migraties later in deze zelfstudie worden uitgevoerd, worden de naamvelden nvarchar(50).

Het kenmerk Kolom

Kenmerken kunnen bepalen hoe klassen en eigenschappen worden toegewezen aan de database. In deze sectie wordt het Column kenmerk gebruikt om de naam van de FirstMidName eigenschap toe te wijzen aan FirstName in de database.

Wanneer de database wordt gemaakt, worden eigenschapsnamen in het model gebruikt voor kolomnamen (behalve wanneer het Column kenmerk wordt gebruikt).

Het Student model gebruikt FirstMidName voor het veld voor de voornaam, omdat het veld mogelijk ook een middelste naam bevat.

Werk het Student.cs bestand bij met de volgende gemarkeerde code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        [StringLength(50)]
        public string LastName { get; set; }
        [StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]
        [Column("FirstName")]
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        public DateTime EnrollmentDate { get; set; }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

Met de voorgaande wijziging wordt Student.FirstMidName in de app toegewezen aan de FirstName kolom van de Student tabel.

Door het toevoegen van het Column kenmerk verandert het achterliggende model van de SchoolContext. Het model achter de SchoolContext komt niet langer overeen met de database. Als de app wordt uitgevoerd voordat migraties worden toegepast, wordt de volgende uitzondering gegenereerd:

SqlException: Invalid column name 'FirstName'.

De database bijwerken:

  • Bouw het project.
  • Open een opdrachtvenster in de projectmap. Voer de volgende opdrachten in om een nieuwe migratie te maken en de database bij te werken:
Add-Migration ColumnFirstName
Update-Database

Met de migrations add ColumnFirstName opdracht wordt het volgende waarschuwingsbericht gegenereerd:

An operation was scaffolded that may result in the loss of data.
Please review the migration for accuracy.

De waarschuwing wordt gegenereerd omdat de naamvelden nu beperkt zijn tot 50 tekens. Als een naam in de database meer dan 50 tekens bevat, zouden het 51e tot en met het laatste teken verloren gaan.

  • De app testen.

Open de tabel Student in SSOX:

Studenten tabel in SSOX na migraties

Voordat de migratie werd toegepast, waren de naamkolommen van het type nvarchar(MAX). De naamkolommen zijn nu nvarchar(50). De kolomnaam is gewijzigd van FirstMidName in FirstName.

Opmerking

In de volgende sectie genereert het bouwen van de app in sommige fasen compilerfouten. De instructies geven aan wanneer de app moet worden gebouwd.

Update van studententiteit

Studententiteit

Werk Models/Student.cs bij met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        [Required]
        [StringLength(50)]
        [Display(Name = "Last Name")]
        public string LastName { get; set; }
        [Required]
        [StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Enrollment Date")]
        public DateTime EnrollmentDate { get; set; }
        [Display(Name = "Full Name")]
        public string FullName
        {
            get
            {
                return LastName + ", " + FirstMidName;
            }
        }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

Het Vereiste kenmerk

Het Required kenmerk maakt de naamkenmerken verplichte velden. Het Required kenmerk is niet nodig voor niet-null-typen, zoals waardetypen (DateTime, intdouble, enzovoort). Typen die niet null kunnen zijn, worden automatisch behandeld als vereiste velden.

Het Required kenmerk kan worden vervangen door een minimale lengteparameter in het StringLength kenmerk:

[Display(Name = "Last Name")]
[StringLength(50, MinimumLength=1)]
public string LastName { get; set; }

Het kenmerk Weergave

Het Display kenmerk geeft aan dat het bijschrift voor de tekstvakken 'Voornaam', 'Achternaam', 'Volledige naam' en 'Inschrijvingsdatum' moet zijn. De standaardbijschriften hadden geen spatie tussen de woorden, bijvoorbeeld 'Achternaam'.

De berekende eigenschap FullName

FullName is een berekende eigenschap die een waarde retourneert die wordt gemaakt door twee andere eigenschappen samen te voegen. FullName kan niet worden ingesteld, het heeft alleen een get accessor. Er wordt geen FullName kolom gemaakt in de database.

De entiteit Docent maken

Entiteit Docent

Maak Models/Instructor.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Instructor
    {
        public int ID { get; set; }

        [Required]
        [Display(Name = "Last Name")]
        [StringLength(50)]
        public string LastName { get; set; }

        [Required]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        [StringLength(50)]
        public string FirstMidName { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Hire Date")]
        public DateTime HireDate { get; set; }

        [Display(Name = "Full Name")]
        public string FullName
        {
            get { return LastName + ", " + FirstMidName; }
        }

        public ICollection<CourseAssignment> CourseAssignments { get; set; }
        public OfficeAssignment OfficeAssignment { get; set; }
    }
}

Meerdere kenmerken kunnen op één regel staan. De HireDate kenmerken kunnen als volgt worden geschreven:

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

De navigatie-eigenschappen van CourseAssignments en OfficeAssignment

De CourseAssignments eigenschappen en OfficeAssignment eigenschappen zijn navigatie-eigenschappen.

Een docent kan een willekeurig aantal cursussen leren, dus CourseAssignments wordt gedefinieerd als een verzameling.

public ICollection<CourseAssignment> CourseAssignments { get; set; }

Als een navigatie-eigenschap meerdere entiteiten bevat:

  • Het moet een lijsttype zijn waarin de vermeldingen kunnen worden toegevoegd, verwijderd en bijgewerkt.

Typen navigatie-eigenschappen zijn onder andere:

  • ICollection<T>
  • List<T>
  • HashSet<T>

Als ICollection<T> opgegeven is, maakt EF Core standaard een HashSet<T> verzameling aan.

De CourseAssignment entiteit wordt uitgelegd in de sectie over veel-op-veel-relaties.

Contoso University-bedrijfsregels geven aan dat een docent maximaal één kantoor kan hebben. De OfficeAssignment eigenschap bevat één OfficeAssignment entiteit. OfficeAssignment is null als er geen kantoor is toegewezen.

public OfficeAssignment OfficeAssignment { get; set; }

De OfficeAssignment-entiteit maken

OfficeAssignment-entiteit

Maak Models/OfficeAssignment.cs met de volgende code:

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class OfficeAssignment
    {
        [Key]
        public int InstructorID { get; set; }
        [StringLength(50)]
        [Display(Name = "Office Location")]
        public string Location { get; set; }

        public Instructor Instructor { get; set; }
    }
}

Het Sleutelkenmerk

Het [Key] kenmerk wordt gebruikt om een eigenschap te identificeren als de primaire sleutel (PK) wanneer de eigenschapsnaam iets anders is dan classnameID of id.

Er is een een-op-nul-of-een-relatie tussen de Instructor en OfficeAssignment entiteiten. Er bestaat alleen een kantoortoewijzing met betrekking tot de docent waaraan deze is toegewezen. De OfficeAssignment PK is ook de vreemde sleutel (FK) voor de Instructor entiteit. EF Core kan InstructorID niet automatisch als de PK van OfficeAssignment herkennen omdat:

  • InstructorID volgt de naamconventie voor ID of classnameID niet.

Daarom wordt het Key kenmerk gebruikt om te identificeren InstructorID als pk:

[Key]
public int InstructorID { get; set; }

De sleutel wordt standaard behandeld als niet-database-gegenereerd door EF Core omdat de kolom bedoeld is voor een identificatierelatie.

De navigatie-eigenschap Instructeur

De OfficeAssignment navigatie-eigenschap voor de Instructor entiteit kan null zijn omdat:

  • Referentietypen (zoals klassen zijn null-baar).
  • Een docent heeft mogelijk geen kantooropdracht.

De OfficeAssignment entiteit heeft een niet-nullable Instructor navigatie-eigenschap omdat:

  • InstructorID is niet nullable.
  • Een kantooropdracht kan niet bestaan zonder docent.

Wanneer een Instructor entiteit een gerelateerde OfficeAssignment entiteit heeft, heeft elke entiteit een verwijzing naar de andere entiteit in de navigatie-eigenschap.

Het [Required] kenmerk kan worden toegepast op de Instructor navigatie-eigenschap:

[Required]
public Instructor Instructor { get; set; }

De voorgaande code geeft aan dat er een gerelateerde docent moet zijn. De voorgaande code is niet nodig omdat de InstructorID vreemde sleutel (die ook de PK is) niet-nullbaar is.

De cursusentiteit wijzigen

Cursusentiteit

Werk Models/Course.cs bij met de volgende code:

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Course
    {
        [DatabaseGenerated(DatabaseGeneratedOption.None)]
        [Display(Name = "Number")]
        public int CourseID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Title { get; set; }

        [Range(0, 5)]
        public int Credits { get; set; }

        public int DepartmentID { get; set; }

        public Department Department { get; set; }
        public ICollection<Enrollment> Enrollments { get; set; }
        public ICollection<CourseAssignment> CourseAssignments { get; set; }
    }
}

De Course entiteit heeft een buitenlandse sleutel (FK) eigenschap DepartmentID. DepartmentID verwijst naar de gerelateerde Department entiteit. De Course entiteit heeft een Department navigatie-eigenschap.

EF Core vereist geen FK-eigenschap voor een gegevensmodel wanneer het model een navigatie-eigenschap voor een gerelateerde entiteit heeft.

EF Core maakt automatisch FK's in de database waar ze nodig zijn. EF Core maakt schaduweigenschappen voor automatisch gemaakte FK's. Door de FK in het gegevensmodel te gebruiken, kunnen updates eenvoudiger en efficiënter worden. Denk bijvoorbeeld aan een model waarin de FK-eigenschap DepartmentIDniet is opgenomen. Wanneer een cursusentiteit wordt opgehaald om te bewerken:

  • De Department entiteit is null als deze niet expliciet wordt geladen.
  • Als u de cursusentiteit wilt bijwerken, moet de Department entiteit eerst worden opgehaald.

Wanneer de FK-eigenschap DepartmentID is opgenomen in het gegevensmodel, hoeft u de Department entiteit niet op te halen vóór een update.

Het kenmerk DatabaseGenerated

Het [DatabaseGenerated(DatabaseGeneratedOption.None)] kenmerk geeft aan dat de PK wordt geleverd door de toepassing in plaats van gegenereerd door de database.

[DatabaseGenerated(DatabaseGeneratedOption.None)]
[Display(Name = "Number")]
public int CourseID { get; set; }

EF Core Standaard wordt ervan uitgegaan dat PK-waarden worden gegenereerd door de db. DOOR DB gegenereerde PK-waarden zijn over het algemeen de beste benadering. Voor Course entiteiten geeft de gebruiker de PK op. Bijvoorbeeld een cursusnummer, zoals een 1000-serie voor de wiskundeafdeling, een serie van 2000 voor de Engelse afdeling.

Het DatabaseGenerated kenmerk kan ook worden gebruikt om standaardwaarden te genereren. De database kan bijvoorbeeld automatisch een datumveld genereren om de datum vast te leggen waarop een rij is gemaakt of bijgewerkt. Zie Gegenereerde eigenschappen voor meer informatie.

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De sleuteleigenschappen en navigatie-eigenschappen van de vreemde sleutel (FK) in de Course-entiteit weerspiegelen de volgende relaties:

Er wordt een cursus toegewezen aan één afdeling, dus er is een DepartmentID FK en een Department navigatie-eigenschap.

public int DepartmentID { get; set; }
public Department Department { get; set; }

Een cursus kan een willekeurig aantal leerlingen/studenten hebben ingeschreven, zodat de Enrollments navigatie-eigenschap een verzameling is:

public ICollection<Enrollment> Enrollments { get; set; }

Een cursus kan worden gegeven door meerdere instructeurs, dus de CourseAssignments navigatie-eigenschap is een verzameling:

public ICollection<CourseAssignment> CourseAssignments { get; set; }

CourseAssignment wordt later uitgelegd.

De entiteit Afdeling maken

Afdelingsentiteit

Maak Models/Department.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Department
    {
        public int DepartmentID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Name { get; set; }

        [DataType(DataType.Currency)]
        [Column(TypeName = "money")]
        public decimal Budget { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Start Date")]
        public DateTime StartDate { get; set; }

        public int? InstructorID { get; set; }

        public Instructor Administrator { get; set; }
        public ICollection<Course> Courses { get; set; }
    }
}

Het kenmerk Kolom

Voorheen werd het Column kenmerk gebruikt om de kolomnaamtoewijzing te wijzigen. In de code voor de Department entiteit wordt het Column kenmerk gebruikt om de toewijzing van het SQL-gegevenstype te wijzigen. De Budget kolom wordt gedefinieerd met behulp van het geldtype SQL Server in de db:

[Column(TypeName="money")]
public decimal Budget { get; set; }

Kolomtoewijzing is over het algemeen niet vereist. EF Core kiest over het algemeen het juiste SQL Server-gegevenstype op basis van het CLR-type voor de eigenschap. Het CLR-type decimal wordt toegewezen aan een SQL Server-type decimal . Budget is voor valuta en het gegevenstype geld is geschikter voor valuta.

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De FK- en navigatie-eigenschappen weerspiegelen de volgende relaties:

  • Een afdeling heeft al dan niet een beheerder.
  • Een beheerder is altijd een instructeur. Daarom is de InstructorID eigenschap opgenomen als de FK voor de Instructor entiteit.

De navigatie-eigenschap heeft een naam Administrator , maar bevat een Instructor entiteit:

public int? InstructorID { get; set; }
public Instructor Administrator { get; set; }

Het vraagteken (?) in de voorgaande code geeft aan dat de eigenschap nullable is.

Een afdeling kan veel cursussen hebben, daarom is er een navigatie-eigenschap genaamd Cursussen.

public ICollection<Course> Courses { get; set; }

Opmerking: Met de conventie EF Core kunt u trapsgewijs verwijderen voor niet-null-FK's en voor veel-op-veel-relaties. Trapsgewijs verwijderen kan leiden tot cirkelvormige regels voor trapsgewijs verwijderen. Cirkulaire regels voor trapsgewijs verwijderen veroorzaken een foutmelding wanneer er een migratie wordt toegevoegd.

Als de Department.InstructorID eigenschap bijvoorbeeld is gedefinieerd als niet-nullable:

  • EF Core hiermee configureert u een regel voor trapsgewijs verwijderen om de afdeling te verwijderen wanneer de docent wordt verwijderd.

  • Het verwijderen van de afdeling wanneer de docent wordt verwijderd, is niet het beoogde gedrag.

  • Met de volgende Fluent-API wordt een beperkingsregel ingesteld in plaats van een cascaderegel.

    modelBuilder.Entity<Department>()
        .HasOne(d => d.Administrator)
        .WithMany()
        .OnDelete(DeleteBehavior.Restrict)
    

Met de voorgaande code wordt het trapsgewijs verwijderen uitgeschakeld in de relatie tussen de afdeling en instructeurs.

De inschrijvingsentiteit bijwerken

Een inschrijvingsrecord is voor één cursus die door één student wordt gevolgd.

Inschrijvingsentiteit

Werk Models/Enrollment.cs bij met de volgende code:

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public enum Grade
    {
        A, B, C, D, F
    }

    public class Enrollment
    {
        public int EnrollmentID { get; set; }
        public int CourseID { get; set; }
        public int StudentID { get; set; }
        [DisplayFormat(NullDisplayText = "No grade")]
        public Grade? Grade { get; set; }

        public Course Course { get; set; }
        public Student Student { get; set; }
    }
}

Eigenschappen van vreemde sleutel en navigatie-eigenschappen

De FK-eigenschappen en navigatie-eigenschappen weerspiegelen de volgende relaties:

Een inschrijvingsrecord is voor één cursus, dus er is een CourseID FK-eigenschap en een Course navigatie-eigenschap:

public int CourseID { get; set; }
public Course Course { get; set; }

Een inschrijvingsrecord is voor één student, dus er is een StudentID FK-eigenschap en een Student navigatie-eigenschap:

public int StudentID { get; set; }
public Student Student { get; set; }

Veel-op-veel-relaties

Er bestaat een veel-op-veelrelatie tussen de Student- en Course-entiteiten. De Enrollment entiteit fungeert als een veel-op-veel-join-tabel met extra gegevens in de database. 'Met payload' betekent dat de Enrollment-tabel behalve FK's voor de verbonden tabellen aanvullende gegevens bevat (in dit geval de PK en Grade).

In de volgende afbeelding ziet u hoe deze relaties eruitzien in een entiteitsdiagram. (Dit diagram is gegenereerd met EF Power Tools voor EF 6.x. Het maken van het diagram maakt geen deel uit van de zelfstudie.)

Student-Course veel-op-veel-relatie

Elke relatielijn heeft een 1 aan het ene uiteinde en een sterretje (*) aan de andere, wat een een-op-veel-relatie aangeeft.

Als de Enrollment tabel geen cijfergegevens bevat, hoeft deze alleen de twee FK's (CourseID en StudentID) te bevatten. Een veel-op-veel-join-tabel zonder inhoud wordt soms een pure join-tabel (PJT) genoemd.

De Instructor en Course entiteiten hebben een veel-op-veel-relatie met behulp van een pure join-tabel.

Opmerking: EF 6.x ondersteunt impliciete jointabellen voor veel-op-veel-relaties, maar EF Core niet. Zie Veel-op-veel-relaties in EF Core 2.0 voor meer informatie.

De entiteit CourseAssignment

CourseAssignment-entiteit

Maak Models/CourseAssignment.cs met de volgende code:

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class CourseAssignment
    {
        public int InstructorID { get; set; }
        public int CourseID { get; set; }
        public Instructor Instructor { get; set; }
        public Course Course { get; set; }
    }
}

Instructeur-naar-cursussen

Instructeur-naar-cursus m:M

De relatie veel-op-veel tussen instructeurs en cursussen:

  • Vereist een jointabel die moet worden vertegenwoordigd door een entiteitsset.
  • Een pure join-tabel (tabel zonder inhoud).

Het is gebruikelijk om een join-entiteit EntityName1EntityName2een naam te geven. Bijvoorbeeld, de jointabel Instructor-to-Courses met dit patroon is CourseInstructor. We raden u echter aan een naam te gebruiken die de relatie beschrijft.

Gegevensmodellen beginnen eenvoudig en groeien. No-payload joins (PJTs) ontwikkelen zich vaak om een payload te bevatten. Wanneer u begint met een beschrijvende entiteitsnaam, hoeft de naam niet te worden gewijzigd wanneer de koppeltabel wordt gewijzigd. Idealiter heeft de join-entiteit een eigen natuurlijke naam (mogelijk één woord) in het bedrijfsdomein. Boeken en klanten kunnen bijvoorbeeld worden gekoppeld aan een koppelentiteit die Ratings heet. Voor de veel-op-veel-verbinding van instructeurs-cursussen heeft CourseAssignment de voorkeur boven CourseInstructor.

Samengestelde sleutel

FK's zijn niet nullable. De twee FK's in CourseAssignment (InstructorID en CourseID) identificeren elke rij van de CourseAssignment tabel uniek. CourseAssignment vereist geen toegewezen PK. De eigenschappen InstructorID en CourseID functioneren als een samengestelde PK. De enige manier om samengestelde SDK's op te EF Core geven, is met de fluent-API. In de volgende sectie ziet u hoe u de samengestelde PK configureert.

De samengestelde sleutel zorgt voor het volgende:

  • Meerdere rijen zijn toegestaan voor één cursus.
  • Meerdere rijen zijn toegestaan voor één docent.
  • Meerdere rijen voor dezelfde docent en cursus zijn niet toegestaan.

De Enrollment join-entiteit definieert een eigen PK, zodat duplicaten van dit type mogelijk zijn. Om dergelijke duplicaten te voorkomen:

  • Voeg een unieke index toe aan de FK-velden of
  • Configureren Enrollment met een primaire samengestelde sleutel die vergelijkbaar is met CourseAssignment. Zie Indexen voor meer informatie.

De DB-context bijwerken

Voeg de volgende gemarkeerde code toe aan Data/SchoolContext.cs:

using ContosoUniversity.Models;
using Microsoft.EntityFrameworkCore;

namespace ContosoUniversity.Models
{
    public class SchoolContext : DbContext
    {
        public SchoolContext(DbContextOptions<SchoolContext> options) : base(options)
        {
        }

        public DbSet<Course> Courses { get; set; }
        public DbSet<Enrollment> Enrollment { get; set; }
        public DbSet<Student> Student { get; set; }
        public DbSet<Department> Departments { get; set; }
        public DbSet<Instructor> Instructors { get; set; }
        public DbSet<OfficeAssignment> OfficeAssignments { get; set; }
        public DbSet<CourseAssignment> CourseAssignments { get; set; }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Course>().ToTable("Course");
            modelBuilder.Entity<Enrollment>().ToTable("Enrollment");
            modelBuilder.Entity<Student>().ToTable("Student");
            modelBuilder.Entity<Department>().ToTable("Department");
            modelBuilder.Entity<Instructor>().ToTable("Instructor");
            modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment");
            modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment");

            modelBuilder.Entity<CourseAssignment>()
                .HasKey(c => new { c.CourseID, c.InstructorID });
        }
    }
}

De voorgaande code voegt de nieuwe entiteiten toe en configureert de samengestelde PK van de CourseAssignment entiteit.

Fluent-API-alternatief voor kenmerken

De OnModelCreating methode in de voorgaande code maakt gebruik van de Fluent-API om gedrag te configureren EF Core . De API wordt 'fluent' genoemd, omdat deze vaak wordt gebruikt door een reeks methode-aanroepen samen te voegen in één instructie. De volgende code is een voorbeeld van de fluent-API:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.Url)
        .IsRequired();
}

In deze zelfstudie wordt de Fluent-API alleen gebruikt voor DB-toewijzingen die niet kunnen worden uitgevoerd met kenmerken. De fluent-API kan echter de meeste opmaak-, validatie- en toewijzingsregels opgeven die kunnen worden uitgevoerd met kenmerken.

Sommige kenmerken, zoals MinimumLength kunnen niet worden toegepast met de fluent-API. MinimumLength wijzigt het schema niet, er wordt alleen een validatieregel voor minimale lengte toegepast.

Sommige ontwikkelaars gebruiken de fluent API liever uitsluitend, zodat ze hun entiteitsklassen 'schoon' kunnen houden. Kenmerken en de fluent-API kunnen worden gemengd. Er zijn enkele configuraties die alleen kunnen worden uitgevoerd met de fluent-API (het opgeven van een samengestelde PK). Er zijn enkele configuraties die alleen kunnen worden uitgevoerd met kenmerken (MinimumLength). De aanbevolen procedure voor het gebruik van fluent API of attributen:

  • Kies een van deze twee benaderingen.
  • Gebruik de gekozen benadering consistent zo veel mogelijk.

Enkele van de kenmerken die in deze zelfstudie worden gebruikt, worden gebruikt voor:

  • Alleen validatie (bijvoorbeeld MinimumLength).
  • EF Core alleen configuratie (bijvoorbeeld HasKey).
  • Validatie en EF Core configuratie (bijvoorbeeld [StringLength(50)]).

Zie Methoden voor configuratie voor meer informatie over kenmerken versus fluent API.

Entiteitsdiagram met relaties

In de volgende afbeelding ziet u het diagram dat EF Power Tools maakt voor het voltooide schoolmodel.

Entiteitsdiagram

In het voorgaande diagram ziet u:

  • Verschillende een-op-veel-relatielijnen (1 tot *).
  • De een-tot-nul-of-een-relatielijn (1 tot 0..1) tussen de Instructor en OfficeAssignment entiteiten.
  • De nul- of een-op-veel-relatielijn (0,.1 tot *) tussen de Instructor en Department entiteiten.

De database met testgegevens seeden

Werk de code bij in Data/DbInitializer.cs:

using System;
using System.Linq;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using ContosoUniversity.Models;

namespace ContosoUniversity.Data
{
    public static class DbInitializer
    {
        public static void Initialize(SchoolContext context)
        {
            //context.Database.EnsureCreated();

            // Look for any students.
            if (context.Student.Any())
            {
                return;   // DB has been seeded
            }

            var students = new Student[]
            {
                new Student { FirstMidName = "Carson",   LastName = "Alexander",
                    EnrollmentDate = DateTime.Parse("2010-09-01") },
                new Student { FirstMidName = "Meredith", LastName = "Alonso",
                    EnrollmentDate = DateTime.Parse("2012-09-01") },
                new Student { FirstMidName = "Arturo",   LastName = "Anand",
                    EnrollmentDate = DateTime.Parse("2013-09-01") },
                new Student { FirstMidName = "Gytis",    LastName = "Barzdukas",
                    EnrollmentDate = DateTime.Parse("2012-09-01") },
                new Student { FirstMidName = "Yan",      LastName = "Li",
                    EnrollmentDate = DateTime.Parse("2012-09-01") },
                new Student { FirstMidName = "Peggy",    LastName = "Justice",
                    EnrollmentDate = DateTime.Parse("2011-09-01") },
                new Student { FirstMidName = "Laura",    LastName = "Norman",
                    EnrollmentDate = DateTime.Parse("2013-09-01") },
                new Student { FirstMidName = "Nino",     LastName = "Olivetto",
                    EnrollmentDate = DateTime.Parse("2005-09-01") }
            };

            foreach (Student s in students)
            {
                context.Student.Add(s);
            }
            context.SaveChanges();

            var instructors = new Instructor[]
            {
                new Instructor { FirstMidName = "Kim",     LastName = "Abercrombie",
                    HireDate = DateTime.Parse("1995-03-11") },
                new Instructor { FirstMidName = "Fadi",    LastName = "Fakhouri",
                    HireDate = DateTime.Parse("2002-07-06") },
                new Instructor { FirstMidName = "Roger",   LastName = "Harui",
                    HireDate = DateTime.Parse("1998-07-01") },
                new Instructor { FirstMidName = "Candace", LastName = "Kapoor",
                    HireDate = DateTime.Parse("2001-01-15") },
                new Instructor { FirstMidName = "Roger",   LastName = "Zheng",
                    HireDate = DateTime.Parse("2004-02-12") }
            };

            foreach (Instructor i in instructors)
            {
                context.Instructors.Add(i);
            }
            context.SaveChanges();

            var departments = new Department[]
            {
                new Department { Name = "English",     Budget = 350000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Abercrombie").ID },
                new Department { Name = "Mathematics", Budget = 100000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Fakhouri").ID },
                new Department { Name = "Engineering", Budget = 350000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Harui").ID },
                new Department { Name = "Economics",   Budget = 100000,
                    StartDate = DateTime.Parse("2007-09-01"),
                    InstructorID  = instructors.Single( i => i.LastName == "Kapoor").ID }
            };

            foreach (Department d in departments)
            {
                context.Departments.Add(d);
            }
            context.SaveChanges();

            var courses = new Course[]
            {
                new Course {CourseID = 1050, Title = "Chemistry",      Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "Engineering").DepartmentID
                },
                new Course {CourseID = 4022, Title = "Microeconomics", Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "Economics").DepartmentID
                },
                new Course {CourseID = 4041, Title = "Macroeconomics", Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "Economics").DepartmentID
                },
                new Course {CourseID = 1045, Title = "Calculus",       Credits = 4,
                    DepartmentID = departments.Single( s => s.Name == "Mathematics").DepartmentID
                },
                new Course {CourseID = 3141, Title = "Trigonometry",   Credits = 4,
                    DepartmentID = departments.Single( s => s.Name == "Mathematics").DepartmentID
                },
                new Course {CourseID = 2021, Title = "Composition",    Credits = 3,
                    DepartmentID = departments.Single( s => s.Name == "English").DepartmentID
                },
                new Course {CourseID = 2042, Title = "Literature",     Credits = 4,
                    DepartmentID = departments.Single( s => s.Name == "English").DepartmentID
                },
            };

            foreach (Course c in courses)
            {
                context.Courses.Add(c);
            }
            context.SaveChanges();

            var officeAssignments = new OfficeAssignment[]
            {
                new OfficeAssignment {
                    InstructorID = instructors.Single( i => i.LastName == "Fakhouri").ID,
                    Location = "Smith 17" },
                new OfficeAssignment {
                    InstructorID = instructors.Single( i => i.LastName == "Harui").ID,
                    Location = "Gowan 27" },
                new OfficeAssignment {
                    InstructorID = instructors.Single( i => i.LastName == "Kapoor").ID,
                    Location = "Thompson 304" },
            };

            foreach (OfficeAssignment o in officeAssignments)
            {
                context.OfficeAssignments.Add(o);
            }
            context.SaveChanges();

            var courseInstructors = new CourseAssignment[]
            {
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Kapoor").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Harui").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Microeconomics" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Zheng").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Macroeconomics" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Zheng").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Calculus" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Fakhouri").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Trigonometry" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Harui").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Composition" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Abercrombie").ID
                    },
                new CourseAssignment {
                    CourseID = courses.Single(c => c.Title == "Literature" ).CourseID,
                    InstructorID = instructors.Single(i => i.LastName == "Abercrombie").ID
                    },
            };

            foreach (CourseAssignment ci in courseInstructors)
            {
                context.CourseAssignments.Add(ci);
            }
            context.SaveChanges();

            var enrollments = new Enrollment[]
            {
                new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alexander").ID,
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID,
                    Grade = Grade.A
                },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alexander").ID,
                    CourseID = courses.Single(c => c.Title == "Microeconomics" ).CourseID,
                    Grade = Grade.C
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alexander").ID,
                    CourseID = courses.Single(c => c.Title == "Macroeconomics" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                        StudentID = students.Single(s => s.LastName == "Alonso").ID,
                    CourseID = courses.Single(c => c.Title == "Calculus" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                        StudentID = students.Single(s => s.LastName == "Alonso").ID,
                    CourseID = courses.Single(c => c.Title == "Trigonometry" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Alonso").ID,
                    CourseID = courses.Single(c => c.Title == "Composition" ).CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Anand").ID,
                    CourseID = courses.Single(c => c.Title == "Chemistry" ).CourseID
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Anand").ID,
                    CourseID = courses.Single(c => c.Title == "Microeconomics").CourseID,
                    Grade = Grade.B
                    },
                new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Barzdukas").ID,
                    CourseID = courses.Single(c => c.Title == "Chemistry").CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Li").ID,
                    CourseID = courses.Single(c => c.Title == "Composition").CourseID,
                    Grade = Grade.B
                    },
                    new Enrollment {
                    StudentID = students.Single(s => s.LastName == "Justice").ID,
                    CourseID = courses.Single(c => c.Title == "Literature").CourseID,
                    Grade = Grade.B
                    }
            };

            foreach (Enrollment e in enrollments)
            {
                var enrollmentInDataBase = context.Enrollment.Where(
                    s =>
                            s.Student.ID == e.StudentID &&
                            s.Course.CourseID == e.CourseID).SingleOrDefault();
                if (enrollmentInDataBase == null)
                {
                    context.Enrollment.Add(e);
                }
            }
            context.SaveChanges();
        }
    }
}

De code hierboven bevat noopgegevens voor de nieuwe entiteiten. Met de meeste code worden nieuwe entiteitsobjecten gemaakt en voorbeeldgegevens geladen. De voorbeeldgegevens worden gebruikt voor het testen. Bekijk Enrollments en CourseAssignments voor voorbeelden van hoeveel-op-veel-join-tabellen kunnen worden geseed.

Een migratie toevoegen

Bouw het project.

Add-Migration ComplexDataModel

In de voorgaande opdracht wordt een waarschuwing weergegeven over mogelijk gegevensverlies.

An operation was scaffolded that may result in the loss of data.
Please review the migration for accuracy.
Done. To undo this action, use 'ef migrations remove'

Als de database update opdracht wordt uitgevoerd, wordt de volgende fout gegenereerd:

The ALTER TABLE statement conflicted with the FOREIGN KEY constraint "FK_dbo.Course_dbo.Department_DepartmentID". The conflict occurred in
database "ContosoUniversity", table "dbo.Department", column 'DepartmentID'.

De migratie toepassen

Nu u een bestaande database hebt, moet u nadenken over het toepassen van toekomstige wijzigingen. In deze zelfstudie ziet u twee benaderingen:

  • De database verwijderen en opnieuw maken
  • Pas de migratie toe op de bestaande database. Hoewel deze methode complexer en tijdrovender is, is dit de voorkeursbenadering voor echte productieomgevingen. Opmerking: dit is een optionele sectie van de zelfstudie. U kunt de stappen om te verwijderen en opnieuw aan te maken uitvoeren en deze sectie overslaan. Als u de stappen in deze sectie wilt volgen, moet u de stappen voor verwijderen en opnieuw aanmaken niet uitvoeren.

De database verwijderen en opnieuw maken

De bijgewerkte code in DbInitializer voegt seed-gegevens toe voor de nieuwe entiteiten. Als u wilt afdwingen EF Core dat u een nieuwe database maakt, moet u de database verwijderen en bijwerken:

Voer in de Pakketbeheer Console (PMC) de volgende opdracht uit:

Drop-Database
Update-Database

Voer Get-Help about_EntityFrameworkCore uit vanuit de PMC om hulpinformatie te krijgen.

Voer de app uit. Als u de app uitvoert, wordt de DbInitializer.Initialize methode uitgevoerd. DbInitializer.Initialize vult de nieuwe database.

Open de DB in SSOX:

  • Als SSOX eerder is geopend, klikt u op de knop Vernieuwen .
  • Vouw het knooppunt Tabellen uit. De gemaakte tabellen worden weergegeven.

Tabellen in SSOX

Bekijk de CourseAssignment tabel.

  • Klik met de rechtermuisknop op de tabel CourseAssignment en selecteer Gegevens weergeven.
  • Controleer of de tabel CourseAssignment gegevens bevat.

CourseAssignment-gegevens in SSOX

De migratie toepassen op de bestaande database

Deze sectie is optioneel. Deze stappen werken alleen als u de voorgaande sectie Verwijderen hebt overgeslagen en de databasesectie opnieuw hebt gemaakt.

Wanneer migraties worden uitgevoerd met bestaande gegevens, zijn er mogelijk FK-beperkingen die niet tevreden zijn met de bestaande gegevens. Met productiegegevens moeten stappen worden ondernomen om de bestaande gegevens te migreren. Deze sectie bevat een voorbeeld van het oplossen van FK-beperkingsschendingen. Breng deze codewijzigingen niet aan zonder een back-up. Breng deze codewijzigingen niet aan als u de vorige sectie hebt voltooid en de database hebt bijgewerkt.

Het bestand {timestamp}_ComplexDataModel.cs bevat de volgende code:

migrationBuilder.AddColumn<int>(
    name: "DepartmentID",
    table: "Course",
    type: "int",
    nullable: false,
    defaultValue: 0);

Met de voorgaande code wordt een niet-nullable DepartmentID FK aan de Course tabel toegevoegd. De database uit de vorige zelfstudie bevat rijen in Course, zodat de tabel niet kan worden bijgewerkt door migraties.

Om de ComplexDataModel migratie te laten werken met bestaande gegevens:

  • Wijzig de code om de nieuwe kolom (DepartmentID) een standaardwaarde te geven.
  • Maak een nepafdeling met de naam Temp om te fungeren als de standaardafdeling.

De beperkingen voor vreemde sleutels oplossen

Werk de ComplexDataModel klassen Up methode bij:

  • Open het bestand {timestamp}_ComplexDataModel.cs.
  • Markeer de coderegel waarmee de DepartmentID kolom wordt toegevoegd aan de Course tabel als commentaar.
migrationBuilder.AlterColumn<string>(
    name: "Title",
    table: "Course",
    maxLength: 50,
    nullable: true,
    oldClrType: typeof(string),
    oldNullable: true);
            
//migrationBuilder.AddColumn<int>(
//    name: "DepartmentID",
//    table: "Course",
//    nullable: false,
//    defaultValue: 0);

Voeg de volgende gemarkeerde code toe. De nieuwe code gaat na het .CreateTable( name: "Department" blok:

migrationBuilder.CreateTable(
    name: "Department",
    columns: table => new
    {
        DepartmentID = table.Column<int>(type: "int", nullable: false)
            .Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
        Budget = table.Column<decimal>(type: "money", nullable: false),
        InstructorID = table.Column<int>(type: "int", nullable: true),
        Name = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: true),
        StartDate = table.Column<DateTime>(type: "datetime2", nullable: false)
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_Department", x => x.DepartmentID);
        table.ForeignKey(
            name: "FK_Department_Instructor_InstructorID",
            column: x => x.InstructorID,
            principalTable: "Instructor",
            principalColumn: "ID",
            onDelete: ReferentialAction.Restrict);
    });

 migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, GETDATE())");
// Default value for FK points to department created above, with
// defaultValue changed to 1 in following AddColumn statement.

migrationBuilder.AddColumn<int>(
    name: "DepartmentID",
    table: "Course",
    nullable: false,
    defaultValue: 1);

Met de voorgaande wijzigingen zijn bestaande Course rijen gerelateerd aan de afdeling Temp nadat de ComplexDataModelUp methode is uitgevoerd.

Een productie-app zou het volgende doen:

  • Voeg code of scripts toe om Department rijen en gerelateerde Course rijen toe te voegen aan de nieuwe Department rijen.
  • Gebruik niet de afdeling Temp of de standaardwaarde voor Course.DepartmentID.

In de volgende tutorial worden gegevens behandeld die gerelateerd zijn.