Bölüm 5, Razor ASP.NET Core'da bulunan EF Core sayfalar - Veri Modeli

Tom Dykstra, Jeremy Likness ve Jon P Smith tarafından

Contoso University web uygulaması, ve Visual Studio kullanarak EF Core Sayfalar web uygulamalarının nasıl oluşturulacağını Razor gösterir. Öğretici serisi hakkında bilgi için ilk öğreticiye bakın.

Çözemediğiniz sorunlarla karşılaşırsanız, tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu oluşturduğunuz kodla karşılaştırın.

Önceki öğreticiler üç varlıklardan oluşan temel bir veri modeliyle çalışıyordu. Bu öğreticide:

• Daha fazla varlık ve ilişki eklenir.
• Veri modeli biçimlendirme, doğrulama ve veritabanı eşleme kuralları belirtilerek özelleştirilir.

Tamamlanan veri modeli aşağıdaki çizimde gösterilmiştir:

Dataedo ile aşağıdaki veritabanı diyagramı yapılmıştır:

Dataedo ile veritabanı diyagramı oluşturmak için:

• Uygulamayı Azure'a dağıtma
• Dataedo'yu bilgisayarınıza indirin ve yükleyin.
• 5 dakika içinde Azure SQL Veritabanı için belge oluşturma yönergelerini izleyin

Önceki Dataedo diyagramında CourseInstructor , Entity Framework tarafından oluşturulan bir birleştirme tablosudur. Daha fazla bilgi için bkz . Çoka çok

Student varlığı

içindeki Models/Student.cs kodu aşağıdaki kodla değiştirin:

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

Yukarıdaki kod bir FullName özellik ekler ve mevcut özelliklere aşağıdaki öznitelikleri ekler:

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

FullName hesaplanan özelliği

FullName , diğer iki özelliğin birleştirilmesiyle oluşturulan bir değer döndüren hesaplanmış bir özelliktir. FullName ayarlanamaz, bu nedenle yalnızca bir get erişimciye sahiptir. FullName Veritabanında sütun oluşturulmaz.

DataType özniteliği

[DataType(DataType.Date)]

Öğrenci kayıt tarihleri için, tüm sayfalar şu anda tarihle birlikte günün saatini görüntüler, ancak yalnızca tarih geçerlidir. Veri ek açıklaması özniteliklerini kullanarak, verileri gösteren her sayfada görüntüleme biçimini düzeltecek bir kod değişikliği yapabilirsiniz.

DataType özniteliği, veritabanı iç türünden daha özel bir veri türü belirtir. Bu durumda, tarih ve saat değil yalnızca tarih görüntülenmelidir. DataType Numaralandırması Date, Time, Telefon Number, Currency, EmailAddress gibi birçok veri türü sağlar. Özniteliği, DataType uygulamanın türe özgü özellikleri otomatik olarak sağlamasına da olanak sağlayabilir. Örnek:

• Bağlantı mailto: için DataType.EmailAddressotomatik olarak oluşturulur.
• Tarih seçici çoğu tarayıcıda sağlanır DataType.Date .

DataType özniteliği HTML 5 data- (belirgin veri tiresi) öznitelikleri yayar. DataType Öznitelikler doğrulama sağlamaz.

DisplayFormat özniteliği

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

DataType.Date görüntülenen tarihin biçimini belirtmez. Varsayılan olarak, tarih alanı sunucunun CultureInfo'sunu temel alan varsayılan biçimlere göre görüntülenir.

DisplayFormat özniteliği, tarih biçimini açıkça belirtmek için kullanılır. ayarı, ApplyFormatInEditMode biçimlendirmenin düzenleme kullanıcı arabirimine de uygulanması gerektiğini belirtir. Bazı alanlar kullanmamalıdır ApplyFormatInEditMode. Örneğin, para birimi simgesi genellikle düzenleme metin kutusunda görüntülenmemelidir.

DisplayFormat özniteliği tek başına kullanılabilir. özniteliğini özniteliğiyle DisplayFormat kullanmak DataType genellikle iyi bir fikirdir. özniteliği, DataType verilerin ekranda nasıl işlendiğinin aksine semantiğini iletir. DataType özniteliği, içinde DisplayFormatbulunmayan aşağıdaki avantajları sağlar:

• Tarayıcı HTML5 özelliklerini etkinleştirebilir. Örneğin, bir takvim denetimi, yerel ayara uygun para birimi simgesi, e-posta bağlantıları ve istemci tarafı giriş doğrulamasını gösterin.
• Varsayılan olarak, tarayıcı verileri yerel ayara göre doğru biçimi kullanarak işler.

Daha fazla bilgi için giriş Etiketi Yardımcısı belgelerine bakın<.>

StringLength özniteliği

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

Veri doğrulama kuralları ve doğrulama hata iletileri özniteliklerle belirtilebilir. StringLength özniteliği, bir veri alanında izin verilen en düşük ve en uzun karakter uzunluğunu belirtir. Gösterilen kod adları en fazla 50 karakterle sınırlar. En düşük dize uzunluğunu ayarlayan bir örnek daha sonra gösterilir.

StringLength özniteliği istemci tarafı ve sunucu tarafı doğrulama da sağlar. En düşük değerin veritabanı şeması üzerinde hiçbir etkisi yoktur.

StringLength özniteliği, kullanıcının bir ad için boşluk girmesini engellemez. RegularExpression özniteliği girişe kısıtlamalar uygulamak için kullanılabilir. Örneğin, aşağıdaki kod ilk karakterin büyük harf olmasını ve kalan karakterlerin alfabetik olmasını gerektirir:

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

Visual Studio

SQL Server Nesne Gezgini'de (SSOX), Student tablosuna çift tıklayarak Student tablo tasarımcısını açın.

Yukarıdaki görüntüde tablonun şeması Student gösterilir. Ad alanlarının türü nvarchar(MAX)vardır. Bu öğreticinin devamında bir geçiş oluşturulduğunda ve uygulandığında, ad alanları dize uzunluğu özniteliklerinin bir sonucu olarak olur nvarchar(50) .

Visual Studio Code

SQLite aracı kullanarak tablonun sütun tanımlarını Student inceleyin. Ad alanlarının türü Textvardır. Ad alanının olarak adlandırıldığını FirstMidNamefark edin. Sonraki bölümde olarak FirstMidName değiştirilmiştir FirstName.

Column özniteliği

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

Öznitelikler, sınıfların ve özelliklerin veritabanına nasıl eşlenebileceğini denetleyebilir. Modelde Student özniteliği, özelliğin Column adını veritabanındaki FirstMidName "FirstName" ile eşlemek için kullanılır.

Veritabanı oluşturulduğunda, modeldeki özellik adları sütun adları için kullanılır (özniteliğin Column kullanılması dışında). Alan Student ikinci ad da içerebileceğinden model ad alanı için kullanır FirstMidName .

özniteliğiyle [Column] , Student.FirstMidName veri modelinde tablonun sütununa eşler FirstNameStudent . özniteliğinin Column eklenmesi, modelinin desteklenmesinde SchoolContextdeğişiklik gösterir. öğesinin yedeklenmesi SchoolContext artık veritabanıyla eşleşir. Bu tutarsızlık, bu öğreticinin ilerleyen bölümlerinde bir geçiş eklenerek çözülecektir.

Gerekli özniteliği

[Required]

özniteliği, Required ad özelliklerini gerekli alanlara getirir. Required Öznitelik, değer türleri (örneğin, DateTime, intve double) gibi null atanamayan türler için gerekli değildir. Null yapılamaz türler otomatik olarak gerekli alanlar olarak kabul edilir.

özniteliğinin Required uygulanabilmesi için MinimumLength ile MinimumLength kullanılması gerekir.

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

MinimumLength ve Required boşluğun doğrulamayı karşılamasına izin verin. RegularExpression Dize üzerinde tam denetim için özniteliğini kullanın.

Display özniteliği

[Display(Name = "Last Name")]

özniteliği, Display metin kutuları için başlık "Ad", "Soyadı", "Tam Ad" ve "Kayıt Tarihi" olması gerektiğini belirtir. Varsayılan başlık sözcükleri bölen boşluk yoktu, örneğin "Soyadı."

Geçiş oluşturma

Uygulamayı çalıştırın ve Öğrenciler sayfasına gidin. Bir özel durum oluşturulur. özniteliği EF'in [Column] adlı FirstNamebir sütunu bulmayı beklemesine neden olur, ancak veritabanındaki sütun adı hala FirstMidNameolur.

Visual Studio

Hata iletisi aşağıdaki örneğe benzer:

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

SchoolContext

• PMC'de, yeni bir geçiş oluşturmak ve veritabanını güncelleştirmek için aşağıdaki komutları girin:

  Add-Migration ColumnFirstName
  Update-Database
  
  

  Bu komutlardan ilki aşağıdaki uyarı iletisini oluşturur:

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

  Ad alanları artık 50 karakterle sınırlı olduğundan uyarı oluşturulur. Veritabanındaki bir ad 50'den fazla karaktere sahipse, 51-son karakter kaybolur.

• SSOX'ta Student tablosunu açın:

  

  Geçiş uygulanmadan önce ad sütunları nvarchar(MAX) türündeydi. Ad sütunları artık nvarchar(50)şeklindedir. Sütun adı olarak değiştirildi FirstMidNameFirstName.

Visual Studio Code

Hata iletisi aşağıdaki örneğe benzer:

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

• Proje klasöründe bir komut penceresi açın. Yeni bir geçiş oluşturmak ve veritabanını güncelleştirmek için aşağıdaki komutları girin:

  dotnet ef migrations add ColumnFirstName
  dotnet ef database update
  

• SQLite aracıyla Student tablosunu inceleyin. Şimdi olan FirstMidName sütundur FirstName.

• Uygulamayı çalıştırın ve Öğrenciler sayfasına gidin.
• Saatlerin giriş yapılmadığını veya tarihlerle birlikte görüntülenmediğini fark edin.
• Yeni Oluştur'u seçin ve 50 karakterden uzun bir ad girmeyi deneyin.

Dekont

Aşağıdaki bölümlerde, uygulamanın bazı aşamalarda oluşturulması derleyici hataları oluşturur. Yönergeler, uygulamanın ne zaman derleneceğini belirtir.

Eğitmen Varlığı

Aşağıdaki kodla oluşturun Models/Instructor.cs :

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

Birden çok öznitelik tek satırda olabilir. HireDate Öznitelikler aşağıdaki gibi yazılabilir:

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

Gezinti özellikleri

Courses ve OfficeAssignment özellikleri gezinti özellikleridir.

Eğitmen herhangi bir sayıda ders verebilir, bu nedenle Courses koleksiyon olarak tanımlanır.

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

Eğitmenin en fazla bir ofisi olabilir, bu nedenle özelliğin OfficeAssignment tek OfficeAssignment bir varlığı vardır. OfficeAssignment hiçbir office atanmamışsa null olur.

public OfficeAssignment OfficeAssignment { get; set; }

OfficeAssignment varlığı

Aşağıdaki kodla oluşturun Models/OfficeAssignment.cs :

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

Key özniteliği

[Key] özniteliği, özellik adı veya IDdışında classnameID bir şey olduğunda bir özelliği birincil anahtar (PK) olarak tanımlamak için kullanılır.

ve OfficeAssignment varlıkları arasında Instructor bire sıfır veya bir ilişkisi vardır. Bir ofis ataması yalnızca atandığı eğitmenle ilişkili olarak bulunur. OfficeAssignment PK aynı zamanda varlığın yabancı anahtarıdır (FKInstructor). Bir tablodaki PK hem PK hem de başka bir tablodaki FK olduğunda bire sıfır veya bir ilişkisi oluşur.

EF CoreID veya classnameID adlandırma kuralına uymadığından otomatik olarak PK OfficeAssignmentInstructorID olarak tanınamıyorInstructorID. Bu nedenle, Key özniteliği PK olarak tanımlamak InstructorID için kullanılır:

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

Varsayılan olarak, EF Core sütun tanımlayıcı bir ilişki için olduğundan anahtarı veritabanı oluşturulmamış olarak ele alır. Daha fazla bilgi için bkz . EF Anahtarları.

Eğitmen gezinti özelliği

Belirli Instructor.OfficeAssignment bir eğitmen için satır OfficeAssignment olmadığından gezinti özelliği null olabilir. Eğitmenin ofis ödevi olmayabilir.

OfficeAssignment.Instructor Yabancı anahtar InstructorID türü null atanamayan bir değer türü olduğundan intgezinti özelliğinin her zaman bir eğitmen varlığı olacaktır. Bir ofis ödevi, eğitmen olmadan mevcut olamaz.

Bir Instructor varlığın ilgili OfficeAssignment bir varlığı olduğunda, her varlığın gezinti özelliğinde diğerine bir başvurusu olur.

Kurs Varlığı

Aşağıdaki kodla güncelleştirin Models/Course.cs :

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

Varlığın Course yabancı anahtar (FK) özelliği DepartmentIDvardır. DepartmentID ilgili Department varlığa işaret eder. Varlığın Course bir Department gezinti özelliği vardır.

EF Core modelin ilgili varlık için gezinti özelliği olduğunda veri modeli için yabancı anahtar özelliği gerektirmez. EF Core gerektiğinde otomatik olarak veritabanında FK'ler oluşturur. EF Coreotomatik olarak oluşturulan FK'ler için gölge özellikler oluşturur. Ancak, FK'yi veri modeline açıkça dahil ederek güncelleştirmeleri daha basit ve daha verimli hale getirebilirsiniz. Örneğin, FK özelliğinin DepartmentIDdahil edilmediği bir model düşünün. Düzenlemek üzere bir kurs varlığı getirildiğinde:

• Department özelliği, null açıkça yüklenmemişse olur.
• Kurs varlığını güncelleştirmek için önce varlığın Department getirilmesi gerekir.

FK özelliği DepartmentID veri modeline dahil edildiğinde, bir güncelleştirmeden önce varlığı getirmeye Department gerek yoktur.

DatabaseGenerated özniteliği

özniteliği, [DatabaseGenerated(DatabaseGeneratedOption.None)] PK'nin veritabanı tarafından oluşturulmak yerine uygulama tarafından sağlandığını belirtir.

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

Varsayılan olarak, EF Core PK değerlerinin veritabanı tarafından oluşturulduğunu varsayar. Veritabanı tarafından oluşturulan genellikle en iyi yaklaşımdır. Varlıklar için Course kullanıcı PK'yı belirtir. Örneğin, matematik bölümü için 1000 serisi, İngilizce bölümü için 2000 serisi gibi bir ders numarası.

Özniteliği, DatabaseGenerated varsayılan değerleri oluşturmak için de kullanılabilir. Örneğin, veritabanı otomatik olarak bir satırın oluşturulduğu veya güncelleştirilildiği tarihi kaydetmek için bir tarih alanı oluşturabilir. Daha fazla bilgi için bkz . Oluşturulan Özellikler.

Yabancı anahtar ve gezinti özellikleri

Varlıktaki Course yabancı anahtar (FK) özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır:

Kurs bir bölüme atandığından FK ve Department gezinti özelliği vardırDepartmentID.

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

Bir kursta kayıtlı herhangi bir sayıda öğrenci olabilir, bu nedenle Enrollments gezinti özelliği bir koleksiyondur:

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

Bir kurs birden çok eğitmen tarafından öğretilebilir, bu nedenle Instructors gezinti özelliği bir koleksiyondur:

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

Departman varlığı

Aşağıdaki kodla oluşturun Models/Department.cs :

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

Column özniteliği

Column Daha önce sütun adı eşlemesini değiştirmek için özniteliği kullanılıyordu. Varlığın kodunda Department , Column SQL veri türü eşlemesini değiştirmek için özniteliği kullanılır. Budget Sütun, veritabanındaki SQL Server para türü kullanılarak tanımlanır:

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

Sütun eşlemesi genellikle gerekli değildir. EF Core özelliği için CLR türüne göre uygun SQL Server veri türünü seçer. CLR decimal türü bir SQL Server decimal türüyle eşler. Budget para birimi içindir ve para birimi veri türü para birimi için daha uygundur.

Yabancı anahtar ve gezinti özellikleri

FK ve gezinti özellikleri aşağıdaki ilişkileri yansıtır:

• Bir bölümün yöneticisi olabilir veya olmayabilir.
• Yönetici her zaman eğitmendir. Bu nedenle InstructorID özelliği, varlığa FK Instructor olarak eklenir.

Gezinti özelliği adlandırılmıştır Administrator ancak bir Instructor varlığı barındırmaktadır:

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

? Yukarıdaki kodda özelliğin null atanabilir olduğunu belirtir.

Bir bölümün birçok kursu olabileceği için Kurslar gezinti özelliği vardır:

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

Kural gereği, EF Core null değer atanamayan FK'ler ve çoka çok ilişkiler için art arda silmeyi etkinleştirir. Bu varsayılan davranış döngüsel art arda silme kurallarına neden olabilir. Döngüsel art arda silme kuralları, geçiş eklendiğinde özel duruma neden olur.

Örneğin, özellik null atanamaz olarak tanımlandıysa Department.InstructorID , EF Core art arda silme kuralı yapılandırılır. Bu durumda, yönetici olarak atanan eğitmen silindiğinde bölüm silinir. Bu senaryoda kısıtlama kuralı daha mantıklı olacaktır. Aşağıdaki akıcı API bir kısıtlama kuralı ayarlar ve art arda silmeyi devre dışı bırakır.

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

Kayıt yabancı anahtarı ve gezinti özellikleri

Kayıt kaydı, bir öğrencinin aldığı bir kursa yöneliktir.

Aşağıdaki kodla güncelleştirin Models/Enrollment.cs :

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

FK özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır:

Kayıt kaydı bir kurs içindir, bu nedenle bir CourseID FK özelliği ve bir Course gezinti özelliği vardır:

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

Kayıt kaydı bir öğrenci içindir, bu nedenle bir StudentID FK özelliği ve bir Student gezinti özelliği vardır:

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

Çoka Çok İlişkiler

ve Course varlıkları arasında Student çoka çok ilişkisi vardır. Varlık, Enrollment veritabanında yükü olan çoka çok birleştirme tablosu olarak çalışır. YükünEnrollment olması, tablonun birleştirilen tablolar için FK'lerin yanı sıra ek veriler içerdiği anlamına gelir. Varlığında Enrollment , FK'ler dışında ek veriler PK ve Grade'tir.

Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğü gösterilmektedir. (Bu diyagram kullanılarak oluşturulmuşturEF 6.x için EF Power Tools . Diyagramı oluşturmak öğreticinin bir parçası değildir.)

Her ilişki çizgisinin bir ucunda 1, diğer ucunda ise bire çok ilişkisini gösteren bir yıldız işareti (*) vardır.

Enrollment Tabloda not bilgileri yoksa, yalnızca iki FK ve içermesi CourseIDStudentIDgerekir. Yükü olmayan çoka çok birleştirme tablosu bazen saf birleştirme tablosu (PJT) olarak adlandırılır.

ve Course varlıklarının Instructor PJT kullanan çoka çok ilişkisi vardır.

Veritabanı bağlamını güncelleştirme

Aşağıdaki kodla güncelleştirin Data/SchoolContext.cs :

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

Yukarıdaki kod yeni varlıkları ekler ve ve Course varlıkları arasındaki Instructor çoka çok ilişkisini yapılandırılır.

Özniteliklere alternatif fluent API

Yukarıdaki OnModelCreating koddaki yöntem, davranışı yapılandırmak EF Core için akıcı API'yi kullanır. API'ye "fluent" adı verilir çünkü genellikle bir dizi yöntem çağrısını tek bir deyimde dizeleyerek kullanılır. Aşağıdaki kod , akıcı API örneğidir:

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

Bu öğreticide, akıcı API yalnızca özniteliklerle yapılamaz veritabanı eşlemesi için kullanılır. Ancak, akıcı API özniteliklerle yapılabilecek biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtebilir.

gibi MinimumLength bazı öznitelikler akıcı API ile uygulanamaz. MinimumLength şemayı değiştirmez, yalnızca minimum uzunluk doğrulama kuralı uygular.

Bazı geliştiriciler varlık sınıflarını temiz tutabilmek için yalnızca akıcı API'yi kullanmayı tercih eder. Öznitelikler ve akıcı API karıştırılabilir. Bileşik PK belirtme gibi yalnızca akıcı API ile yapılabilecek bazı yapılandırmalar vardır. Yalnızca özniteliklerle (MinimumLength) yapilebilen bazı yapılandırmalar vardır. Akıcı API veya öznitelikleri kullanmak için önerilen uygulama:

• Bu iki yaklaşımdan birini seçin.
• Seçilen yaklaşımı mümkün olduğunca tutarlı bir şekilde kullanın.

Bu öğreticide kullanılan özniteliklerden bazıları şunlar için kullanılır:

• Yalnızca doğrulama (örneğin, MinimumLength).
• EF Core yalnızca yapılandırma (örneğin, HasKey).
• Doğrulama ve EF Core yapılandırma (örneğin, [StringLength(50)]).

Öznitelikler ve akıcı API hakkında daha fazla bilgi için bkz . Yapılandırma yöntemleri.

Veritabanının tohumunu oluşturma

içindeki Data/DbInitializer.cskodu güncelleştirin:

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

Yukarıdaki kod, yeni varlıklar için tohum verileri sağlar. Bu kodun çoğu yeni varlık nesneleri oluşturur ve örnek verileri yükler. Örnek veriler test için kullanılır.

Geçişi uygulama veya bırakma ve yeniden oluşturma

Mevcut veritabanıyla, veritabanını değiştirmeye yönelik iki yaklaşım vardır:

• Veritabanını bırakın ve yeniden oluşturun. SQLite kullanırken bu bölümü seçin.
• Geçişi var olan veritabanına uygulayın. Bu bölümdeki yönergeler SQLite için değil yalnızca SQL Server için çalışır.

İki seçenek de SQL Server için çalışır. Apply-migration yöntemi daha karmaşık ve zaman alıcı olsa da, gerçek dünya, üretim ortamları için tercih edilen yaklaşımdır.

Veritabanını bırakma ve yeniden oluşturma

Yeni veritabanı oluşturmaya zorlamak EF Core için veritabanını bırakın ve güncelleştirin:

Visual Studio

• Migrations klasörünü silin.
• Paket Yöneticisi Konsolu'nda (PMC) aşağıdaki komutları çalıştırın:

Drop-Database
Add-Migration InitialCreate
Update-Database

Visual Studio Code

• Bir komut penceresi açın ve proje klasörüne gidin. Proje klasörü dosyayı içerir ContosoUniversity.csproj .
• Migrations klasörünü silin.
• Aşağıdaki komutları çalıştırın:

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

Uygulamayı çalıştırma. Uygulamayı çalıştırmak yöntemini çalıştırır DbInitializer.Initialize . yeni DbInitializer.Initialize veritabanını doldurur.

Visual Studio

Veritabanını SSOX'ta açın:

• SSOX daha önce açıldıysa Yenile düğmesine tıklayın.
• Tablolar düğümünü genişletin. Oluşturulan tablolar görüntülenir.

Visual Studio Code

Veritabanını incelemek için bir SQLite aracı kullanın:

• Yeni tablolar ve sütunlar.
• Tablolarda dağıtılmış veriler.

Sonraki adımlar

Sonraki iki öğretici, ilgili verilerin nasıl okunup güncelleştirileceğini gösterir.

Önceki öğreticiSonraki öğretici