Část 5, Razor Stránky s EF Core ASP.NET Jádrem – datový model

Tom Dykstra, Jeremy Likness a Jon P Smith

Webová aplikace Contoso University ukazuje, jak vytvářet Razor webové aplikace Pages pomocí EF Core sady Visual Studio. Informace o sérii kurzů najdete v prvním kurzu.

Pokud narazíte na problémy, které nemůžete vyřešit, stáhněte si dokončenou aplikaci a porovnejte tento kód s tím, co jste vytvořili podle kurzu.

Předchozí kurzy pracovaly se základním datovým modelem složeným ze tří entit. V tomto kurzu:

• Přidají se další entity a relace.
• Datový model je přizpůsobený zadáním pravidel formátování, ověřování a mapování databáze.

Dokončený datový model je znázorněn na následujícím obrázku:

Následující diagram databáze byl proveden pomocí dataedo:

Vytvoření databázového diagramu pomocí Dataedo:

• Nasazení aplikace do Azure
• Stáhněte a nainstalujte dataedo do počítače.
• Postupujte podle pokynů vygenerování dokumentace ke službě Azure SQL Database za 5 minut.

V předchozím diagramu CourseInstructor Dataedo je tabulka spojení vytvořená rozhraním Entity Framework. Další informace najdete v tématu M:N

Entita Student

Nahraďte kód v souboru Models/Student.cs následujícím kódem:

C#

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; }
    }
}

Předchozí kód přidá FullName vlastnost a přidá do existujících vlastností následující atributy:

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

Počítaná vlastnost FullName

FullName je počítaná vlastnost, která vrací hodnotu vytvořenou zřetězením dvou dalších vlastností. FullName nejde nastavit, takže má jenom přístupový objekt get. V databázi se nevytvořil žádný FullName sloupec.

Atribut DataType

C#

[DataType(DataType.Date)]

U dat zápisu studentů se na všech stránkách aktuálně zobrazuje čas dne spolu s datem, i když je relevantní jenom datum. Pomocíatributůch

Atribut DataType určuje datový typ, který je konkrétnější než vnitřní typ databáze. V tomto případě by se mělo zobrazit jenom datum, nikoli datum a čas. Výčet DataType poskytuje mnoho datových typů, jako je datum, čas, telefonní číslo, měna, EmailAddress atd. Atribut DataType může také aplikaci povolit, aby automaticky poskytovala funkce specifické pro typ. Příklad:

• Odkaz mailto: se automaticky vytvoří pro DataType.EmailAddress.
• Ve většině prohlížečů je k dispozici DataType.Date selektor data.

Atribut DataType generuje atributy HTML 5 data- (vyslovuje se pomlčka dat). Atributy DataType neposkytují ověření.

Atribut DisplayFormat

C#

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

DataType.Date nezadá formát zobrazeného data. Ve výchozím nastavení se pole data zobrazí podle výchozích formátů založených na souboru CultureInfo serveru.

Atribut DisplayFormat se používá k explicitní zadání formátu data. Nastavení ApplyFormatInEditMode určuje, že formátování se má použít také v uživatelském rozhraní pro úpravy. Některá pole by neměla používat ApplyFormatInEditMode. Symbol měny by se například neměl zobrazovat v textovém poli pro úpravy.

Atribut DisplayFormat lze použít sám. Obecně je vhodné použít DataType atribut s atributem DisplayFormat . Atribut DataType vyjadřuje sémantiku dat na rozdíl od toho, jak je vykreslit na obrazovce. Atribut DataType poskytuje následující výhody, které nejsou k dispozici v DisplayFormat:

• Prohlížeč může povolit funkce HTML5. Můžete například zobrazit ovládací prvek kalendáře, symbol měny odpovídající národnímu prostředí, e-mailové odkazy a ověření vstupu na straně klienta.
• Ve výchozím nastavení prohlížeč vykreslí data pomocí správného formátu na základě národního prostředí.

Další informace najdete v dokumentaci ke vstupním> pomocným <rutině značek.

Atribut StringLength

C#

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

Pomocí atributů je možné zadat pravidla ověření dat a chybové zprávy ověřování. Atribut StringLength určuje minimální a maximální délku znaků, které jsou povoleny v datovém poli. Zobrazený kód omezuje názvy maximálně na 50 znaků. Příklad, který nastaví minimální délku řetězce, se zobrazí později.

Atribut StringLength také poskytuje ověřování na straně klienta a na straně serveru. Minimální hodnota nemá žádný vliv na schéma databáze.

Atribut StringLength nezabrání uživateli v zadávání prázdných znaků pro jméno. Atribut RegularExpression lze použít k použití omezení pro vstup. Například následující kód vyžaduje, aby první znak byl velkým písmenem a zbývající znaky byly abecední:

C#

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

Visual Studio

V SQL Serveru Průzkumník objektů (SSOX) otevřete návrháře tabulek Student poklikáním na tabulku Student.

Předchozí obrázek znázorňuje schéma tabulky Student . Pole názvů mají typ nvarchar(MAX). Při vytvoření a použití migrace později v tomto kurzu se pole názvů stanou nvarchar(50) výsledkem atributů délky řetězce.

Visual Studio Code

Pomocí nástroje SQLite prozkoumejte definice sloupců tabulky Student . Pole názvů mají typ Text. Všimněte si, že se nazývá FirstMidNamepole jméno . V další části FirstMidName se změní na FirstName.

Atribut Column

C#

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

Atributy mohou řídit, jak se třídy a vlastnosti mapují na databázi. Student V modelu Column se atribut používá k mapování názvu FirstMidName vlastnosti na "FirstName" v databázi.

Při vytváření databáze se názvy vlastností v modelu používají pro názvy sloupců (s výjimkou použití atributu Column ). Model Student používá FirstMidName pro pole s křestní jméno, protože pole může obsahovat také prostřední název.

S atributem [Column] Student.FirstMidName se v datovém modelu mapuje na FirstName sloupec Student tabulky. Přidání atributu Column změní model backing the SchoolContext. Model, který SchoolContext už databázi nepodporuje, neodpovídá. Tento nesrovnalosti vyřešíte přidáním migrace později v tomto kurzu.

Požadovaný atribut

C#

[Required]

Atribut Required vytvoří požadované vlastnosti názvu. Atribut Required není potřeba pro typy bez hodnoty null, jako jsou například typy hodnot (například DateTime, inta double). Typy, které nemohou být null, se automaticky považují za povinná pole.

Atribut Required musí být použit s vynuceným vynuceným atributem MinimumLength MinimumLength .

C#

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

MinimumLength a Required povolte, aby ověření splňovalo prázdné znaky. RegularExpression Atribut použijte pro úplnou kontrolu nad řetězcem.

Atribut Display

C#

[Display(Name = "Last Name")]

Atribut Display určuje, že titulek textových polí by měl být "Jméno", "Příjmení", "Celé jméno" a "Datum registrace". Výchozí titulky neměly žádné mezery, které by dělily slova, například "Příjmení".

Vytvoření migrace

Spusťte aplikaci a přejděte na stránku Studenti. Vyvolá se výjimka. Atribut [Column] způsobí, že EF očekává nalezení sloupce s názvem FirstName, ale název sloupce v databázi je stále FirstMidName.

Visual Studio

Chybová zpráva je podobná následujícímu příkladu:

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

SchoolContext

• V PMC zadejte následující příkazy pro vytvoření nové migrace a aktualizaci databáze:

  PowerShell

  Add-Migration ColumnFirstName
  Update-Database
  
  

  První z těchto příkazů vygeneruje následující zprávu upozornění:

  text

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

  Upozornění se vygeneruje, protože pole názvů jsou teď omezená na 50 znaků. Pokud název v databázi obsahoval více než 50 znaků, ztratí se 51 až poslední znak.

• Otevřete tabulku Student v SSOX:

  

  Před použitím migrace byly sloupce názvů typu nvarchar(MAX). Sloupce názvů jsou nyní nvarchar(50). Název sloupce se změnil z FirstMidName na FirstName.

Visual Studio Code

Chybová zpráva je podobná následujícímu příkladu:

SqliteException: SQLite Error 1: 'no such column: s.FirstName'.

• Otevřete příkazové okno ve složce projektu. Zadáním následujících příkazů vytvořte novou migraci a aktualizujte databázi:

  .NET CLI

  dotnet ef migrations add ColumnFirstName
  dotnet ef database update
  

• Prozkoumejte tabulku Student pomocí nástroje SQLite. Sloupec, který byl FirstMidName nyní FirstName.

• Spusťte aplikaci a přejděte na stránku Studenti.
• Všimněte si, že časy nejsou vstupní ani zobrazené spolu s kalendářními daty.
• Vyberte Vytvořit nový a zkuste zadat název delší než 50 znaků.

Poznámka

V následujících částech sestavení aplikace v některých fázích generuje chyby kompilátoru. Pokyny určují, kdy se má aplikace sestavit.

Entita instruktora

Vytvořte Models/Instructor.cs pomocí následujícího kódu:

C#

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; }
    }
}

Více atributů může být na jednom řádku. Atributy HireDate lze zapsat takto:

C#

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

Vlastnosti navigace

Vlastnosti Courses a OfficeAssignment vlastnosti jsou navigační vlastnosti.

Instruktor může učit libovolný počet kurzů, takže Courses je definován jako kolekce.

C#

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

Instruktor může mít maximálně jednu kancelář, takže OfficeAssignment vlastnost obsahuje jednu OfficeAssignment entitu. OfficeAssignment má hodnotu null, pokud není přiřazena žádná kancelář.

C#

public OfficeAssignment OfficeAssignment { get; set; }

Entita OfficeAssignment

Vytvořte Models/OfficeAssignment.cs pomocí následujícího kódu:

C#

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; }
    }
}

Atribut Klíč

Atribut [Key] slouží k identifikaci vlastnosti jako primárního klíče (PK), pokud je název vlastnosti něco jiného než classnameID nebo ID.

Mezi entitami Instructor OfficeAssignment existuje vztah 1:1 nebo 1. Přiřazení kanceláře existuje pouze ve vztahu k instruktorovi, ke kterému je přiřazený. Pk OfficeAssignment je také jeho cizí klíč (FK) pro entitu Instructor . Relace 1:0 nebo 1 nastane v případě, že pk v jedné tabulce je PK i FK v jiné tabulce.

EF Core nemůže automaticky rozpoznat InstructorID jako PK, OfficeAssignment protože InstructorID neodpovídá konvenci pojmenování ID nebo classnameID. Proto se Key atribut používá k identifikaci InstructorID jako PK:

C#

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

Ve výchozím nastavení považuje klíč za negenerovaný databází, EF Core protože sloupec slouží k identifikaci relace. Další informace najdete v tématu Klíče EF.

Vlastnost navigace instruktora

Vlastnost Instructor.OfficeAssignment navigace může mít hodnotu null, protože pro daného instruktora nemusí být OfficeAssignment řádek. Instruktor nemusí mít zadání kanceláře.

Vlastnost OfficeAssignment.Instructor navigace bude mít vždy entitu instruktora, protože typ cizího klíče InstructorID je int, typ hodnoty, který není null. Zadání kanceláře nemůže existovat bez instruktora.

Pokud má entita Instructor související OfficeAssignment entitu, každá entita má ve své navigační vlastnosti odkaz na druhou entitu.

Entita kurzu

Aktualizujte Models/Course.cs následujícím kódem:

C#

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; }
    }
}

Entita Course má vlastnost DepartmentIDcizího klíče (FK). DepartmentID odkazuje na související Department entitu. Entita Course má Department navigační vlastnost.

EF Core nevyžaduje vlastnost cizího klíče pro datový model, pokud má model navigační vlastnost pro související entitu. EF Core v databázi automaticky vytváří sady FK, kdekoli jsou potřeba. EF Core vytvoří stínové vlastnosti pro automaticky vytvořené sady FK. Explicitní zahrnutí FK do datového modelu však může zjednodušit a zefektivnit aktualizace. Představte si například model, ve kterém není zahrnuta vlastnost DepartmentID FK. Když se entita kurzu načte pro úpravy:

• Vlastnost Department je null , pokud není explicitně načtena.
• Chcete-li aktualizovat entitu kurzu, musí být entita Department nejprve načtena.

Pokud je vlastnost DepartmentID FK součástí datového modelu, není nutné před aktualizací načíst entitu Department .

Atribut DatabaseGenerated

Atribut [DatabaseGenerated(DatabaseGeneratedOption.None)] určuje, že PK je poskytována aplikací místo generování databáze.

C#

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

Ve výchozím nastavení se předpokládá, EF Core že databáze generuje hodnoty PK. Vygenerovaná databáze je obecně nejlepší přístup. Pro Course entity určuje uživatel PK. Například číslo kurzu, například 1000 řad pro matematické oddělení, 2000 série pro anglické oddělení.

Atribut DatabaseGenerated lze také použít k vygenerování výchozích hodnot. Databáze může například automaticky vygenerovat pole kalendářního data pro zaznamenání data vytvoření nebo aktualizace řádku. Další informace naleznete v tématu Vygenerované vlastnosti.

Vlastnosti cizího klíče a navigace

Vlastnosti cizího klíče (FK) a vlastnosti navigace v entitě Course odrážejí následující relace:

Kurz je přiřazen k jednomu oddělení, takže je k DepartmentID dispozici FK a Department navigační vlastnost.

C#

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

Kurz může mít v něm zaregistrovaný libovolný počet studentů, takže Enrollments navigační vlastnost je kolekce:

C#

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

Kurz může učit více instruktorů, takže Instructors navigační vlastnost je kolekce:

C#

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

Entita Oddělení

Vytvořte Models/Department.cs pomocí následujícího kódu:

C#

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; }
    }
}

Atribut Column

Dříve byl Column atribut použit ke změně mapování názvů sloupců. V kódu entity Column se atribut používá ke změně mapování datového Department typu SQL. Sloupec Budget se definuje pomocí typu peněz SQL Serveru v databázi:

C#

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

Mapování sloupců se obecně nevyžaduje. EF Core zvolí odpovídající datový typ SQL Serveru na základě typu CLR pro vlastnost. Typ CLR decimal se mapuje na typ SQL Serveru decimal . Budget je pro měnu a datový typ peněz je vhodnější pro měnu.

Vlastnosti cizího klíče a navigace

Vlastnosti FK a navigace odrážejí následující relace:

• Oddělení může nebo nemusí mít správce.
• Správce je vždy instruktor. InstructorID Proto je vlastnost zahrnuta jako FK entityInstructor.

Navigační vlastnost je pojmenovaná Administrator , ale obsahuje entitu Instructor :

C#

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

V ? předchozím kódu určuje vlastnost nullable.

Oddělení může mít mnoho kurzů, takže je zde vlastnost Navigace v kurzech:

C#

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

Podle konvence EF Core umožňuje kaskádové odstranění pro nenulové FK a pro relace M:N. Toto výchozí chování může vést k cyklický kaskádový odstranění pravidel. Cyklické kaskádové odstranění pravidel způsobí výjimku při přidání migrace.

Pokud Department.InstructorID byla například vlastnost definována jako nenulová, EF Core nakonfigurovala by kaskádové pravidlo odstranění. V takovém případě by se oddělení odstranilo, když se odstraní instruktor přiřazený jako správce. V tomto scénáři by pravidlo omezení dávalo větší smysl. Následující fluentové rozhraní API by nastavilo pravidlo omezení a zakázalo kaskádové odstranění.

C#

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

Vlastnosti cizího klíče zápisu a navigace

Záznam o registraci je určen pro jeden kurz pořízený jedním studentem.

Aktualizujte Models/Enrollment.cs následujícím kódem:

C#

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; }
    }
}

Vlastnosti FK a navigační vlastnosti odrážejí následující relace:

Záznam registrace je pro jeden kurz, takže vlastnost CourseID FK a Course navigační vlastnost:

C#

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

Záznam registrace je určený pro jednoho studenta, takže vlastnost StudentID FK a Student navigační vlastnost:

C#

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

Relace M:N

Mezi entitami Student Course a entitami existuje vztah M:N. Entita Enrollment funguje jako tabulka spojení M:N s datovou částí v databázi. Datová část znamená, že Enrollment tabulka obsahuje další data kromě FK pro spojené tabulky. V entitě Enrollment jsou další data kromě FK PK a Grade.

Následující obrázek znázorňuje, jak tyto relace vypadají v diagramu entit. (Tento diagram byl generován pomocí EF Power Tools pro EF 6.x. Vytvoření diagramu není součástí kurzu.)

Každá čára relace má na jednom konci 1 a hvězdičku (*) na druhé, která označuje relaci 1:N.

Enrollment Pokud tabulka neobsahuje informace o známce, musí obsahovat pouze dvě sady FK CourseID a StudentID. Tabulka spojení M:N bez datové části se někdy označuje jako čistá join table (PJT).

Course Entity Instructor mají relaci M:N pomocí PJT.

Aktualizace kontextu databáze

Aktualizujte Data/SchoolContext.cs následujícím kódem:

C#

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<Instructor>().ToTable(nameof(Instructor));
        }
    }
}

Předchozí kód přidá nové entity a nakonfiguruje vztah M:N mezi entitami Instructor a Course entitami.

Alternativa rozhraní Fluent API k atributům

Metoda OnModelCreating v předchozím kódu používá rozhraní API fluent ke konfiguraci EF Core chování. Rozhraní API se nazývá "fluent", protože se často používá řetězcem řady volání metod do jednoho příkazu. Následující kód je příkladem rozhraní FLUENT API:

C#

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

V tomto kurzu se rozhraní API fluent používá pouze pro mapování databáze, které se nedají provádět s atributy. Rozhraní API fluent však může určovat většinu pravidel formátování, ověřování a mapování, která se dají provádět s atributy.

Některé atributy, jako MinimumLength je například nelze použít s rozhraním FLUENT API. MinimumLength nezmění schéma, použije pouze ověřovací pravidlo minimální délky.

Někteří vývojáři raději používají rozhraní API fluent výhradně, aby mohli třídy entit udržovat čisté. Atributy a fluentské rozhraní API je možné kombinovat. Existují některé konfigurace, které je možné provádět pouze s rozhraním FLUENT API, například zadáním složené infrastruktury veřejných klíčů. Existují některé konfigurace, které je možné provádět pouze s atributy (MinimumLength). Doporučený postup pro používání rozhraní API nebo atributů fluent:

• Zvolte jeden z těchto dvou přístupů.
• Zvolený přístup používejte co nejvíce konzistentně.

Některé atributy použité v tomto kurzu se používají pro:

• Pouze ověřování (například MinimumLength).
• EF Core pouze konfigurace (například HasKey).
• Ověřování a EF Core konfigurace (například [StringLength(50)]).

Další informace o atributech a rozhraní API fluent naleznete v tématu Metody konfigurace.

Počáteční hodnota databáze

Aktualizujte kód v Data/DbInitializer.cs:

C#

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();
        }
    }
}

Předchozí kód poskytuje počáteční data pro nové entity. Většina tohoto kódu vytvoří nové objekty entity a načte ukázková data. Ukázková data se používají k testování.

Použití migrace nebo vyřazení a opětovné vytvoření

U existující databáze existují dva přístupy ke změně databáze:

• Odstraňte databázi a znovu ji vytvořte. Tuto část zvolte při použití SQLite.
• Použijte migraci na existující databázi. Pokyny v této části fungují jenom pro SQL Server, ne pro SQLite.

Obě možnosti fungují pro SQL Server. I když je metoda apply-migration složitější a časově náročná, je to upřednostňovaný přístup pro skutečná produkční prostředí.

Odstranění a opětovné vytvoření databáze

Pokud chcete vynutit EF Core vytvoření nové databáze, odstraňte a aktualizujte databázi:

Visual Studio

• Odstraňte složku Migrace.
• V konzole Správce balíčků (PMC) spusťte následující příkazy:

PowerShell

Drop-Database
Add-Migration InitialCreate
Update-Database

Visual Studio Code

• Otevřete příkazové okno a přejděte do složky projektu. Složka projektu obsahuje ContosoUniversity.csproj soubor.
• Odstraňte složku Migrace.
• Spusťte následující příkazy:

.NET CLI

dotnet ef database drop --force
dotnet ef migrations add InitialCreate
dotnet ef database update

Spustit aplikaci. Spuštění aplikace spustí metodu DbInitializer.Initialize . Naplní DbInitializer.Initialize novou databázi.

Visual Studio

Otevřete databázi v SSOX:

• Pokud jste SSOX otevřeli dříve, klikněte na tlačítko Aktualizovat .
• Rozbalte uzel Tabulky. Zobrazí se vytvořené tabulky.

Visual Studio Code

K prozkoumání databáze použijte nástroj SQLite:

• Nové tabulky a sloupce
• Počáteční data v tabulkách

Další kroky

V dalších dvou kurzech se dozvíte, jak číst a aktualizovat související data.

Předchozí kurz Další kurz