Все о работе с моделями многие-ко-многим в ASP.NET MVC 5 Полное руководство с примерами кода

Работа с ассоциациями многие-ко-многим в ASP.NET MVC 5

В этой части статьи мы рассмотрим, как настраивать и использовать ассоциации многие-ко-многим в приложениях ASP.NET MVC 5. Это позволяет создавать сложные связи между сущностями, что может быть полезно для различных сценариев, таких как системы управления студентами и курсами, где один студент может записаться на несколько курсов, а каждый курс может быть пройден многими студентами.

Для начала создадим две сущности: Student и Course. Эти сущности будут связаны типом отношения многие-ко-многим через промежуточную сущность Enrollment.

Создадим класс Student:

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 virtual ICollection<Enrollment> Enrollments { get; set; }
}

Далее создадим класс Course:

public class Course
{
[DatabaseGenerated(DatabaseGeneratedOption.None)]
public int CourseID { get; set; }
public string Title { get; set; }
public int Credits { get; set; }
public virtual ICollection<Enrollment> Enrollments { get; set; }
}

И, наконец, промежуточный класс Enrollment, который будет связывать студентов и курсы:

public class Enrollment
{
public int EnrollmentID { get; set; }
public int CourseID { get; set; }
public int StudentID { get; set; }
[DataType(DataType.Currency)]
[DisplayFormat(DataFormatString = "{0:C}", NullDisplayText = "No", ApplyFormatInEditMode = true)]
public decimal? Grade { get; set; }
public virtual Course Course { get; set; }
public virtual Student Student { get; set; }
}

Для корректной работы с этими сущностями нужно настроить контекст данных. Обновим класс SchoolContext следующим образом:

public class SchoolContext : DbContext
{
public DbSet<Student> Students { get; set; }
public DbSet<Course> Courses { get; set; }
public DbSet<Enrollment> Enrollments { get; set; }
protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
modelBuilder.Entity<Course>()
.HasMany(c => c.Enrollments)
.WithRequired(e => e.Course)
.HasForeignKey(e => e.CourseID);
modelBuilder.Entity<Student>()
.HasMany(s => s.Enrollments)
.WithRequired(e => e.Student)
.HasForeignKey(e => e.StudentID);
}
}

Чтобы применить эти изменения в базе данных, выполните миграцию:

PM> Add-Migration InitialCreate
PM> Update-Database

Теперь у нас есть основа для работы с ассоциациями многие-ко-многим в ASP.NET MVC 5. В следующем шаге можно создать контроллеры и представления для управления студентами, курсами и их записями.

Определение и настройка моделей

Во-первых, создайте классы моделей, которые будут соответствовать таблицам в базе данных. Например, для отображения информации о преподавателях можно создать класс Instructor с такими свойствами, как InstructorID, FirstName, LastName и HireDate. Код будет выглядеть следующим образом:

public class Instructor
{
public int InstructorID { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime HireDate { get; set; }
}

Дальше можно добавить класс Course, который связывает преподавателей с курсами. Этот класс будет включать свойство CourseID, Title, Credits и InstructorID. Пример кода приведен ниже:

public class Course
{
public int CourseID { get; set; }
public string Title { get; set; }
public int Credits { get; set; }
public int InstructorID { get; set; }
public virtual Instructor Instructor { get; set; }
}

Для правильного отображения данных на страницах можно использовать атрибуты. Например, для отображения даты в формате «день-месяц-год» можно использовать атрибут [DisplayFormat(DataFormatString = "{0:dd-MM-yyyy}")] перед свойством HireDate. Вот как это будет выглядеть в коде:

public class Instructor
{
public int InstructorID { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
[DisplayFormat(DataFormatString = "{0:dd-MM-yyyy}")]
public DateTime HireDate { get; set; }
}

Для обновления схемы базы данных с новыми моделями можно использовать команду add-migration в консоли диспетчера пакетов. Например, если добавить свойство Grade в модель Course, то сначала обновите класс:

public class Course
{
public int CourseID { get; set; }
public string Title { get; set; }
public int Credits { get; set; }
public int InstructorID { get; set; }
public string Grade { get; set; }
public virtual Instructor Instructor { get; set; }
}

Далее выполните команду add-migration AddGradeToCourse, после чего обновите базу данных командой update-database. Это добавит новый столбец Grade в таблицу Courses.

В завершение, чтобы увидеть изменения на страницах, обновите представления. Например, добавьте отображение нового свойства в таблицу курсов:

<table>
<tr>
<th>Title</th>
<th>Credits</th>
<th>Grade</th>
</tr>
@foreach (var item in Model.Courses) {
<tr>
<td>@item.Title</td>
<td>@item.Credits</td>
<td>@item.Grade</td>
</tr>
}
</table>

Следуя этим шагам, можно успешно настроить модели, обеспечить корректное отображение данных и поддерживать актуальность структуры базы данных в вашем веб-приложении.

Создание сущностей и их атрибуты

Для начала создадим сущность Instructor, представляющую преподавателей. Эта сущность будет содержать основные данные, такие как идентификатор, имя и дату найма.csharpCopy codenamespace ContosoUniversity.Models

{

public class Instructor

{

public int InstructorID { get; set; }

public string LastName { get; set; }

public string FirstMidName { get; set; }

public DateTime HireDate { get; set; }

public virtual ICollection Courses { get; set; }

}

}

В данном примере мы создаем класс Instructor в пространстве имен ContosoUniversity.Models. Атрибут InstructorID является первичным ключом, который уникально идентифицирует каждого преподавателя. Поля LastName, FirstMidName и HireDate содержат информацию о фамилии, имени и дате найма соответственно. Коллекция Courses позволяет установить связь «один ко многим» с курсами, которые ведет преподаватель.

Дальше можно добавить некоторые атрибуты для более точной настройки сущности. Например, атрибут [Required] делает поле обязательным для заполнения, а [StringLength(50)] ограничивает длину строки:

csharpCopy codenamespace ContosoUniversity.Models

{

public class Instructor

{

public int InstructorID { get; set; }

[Required]

[StringLength(50, ErrorMessage = «Имя не должно превышать 50 символов.»)]

public string LastName { get; set; }

[Required]

[StringLength(50, ErrorMessage = «Имя не должно превышать 50 символов.»)]

public string FirstMidName { get; set; }

[DataType(DataType.Date)]

[Display(Name = «Дата найма»)]

public DateTime HireDate { get; set; }

public virtual ICollection Courses { get; set; }

}

}

Обратите внимание, что атрибут [DataType(DataType.Date)] и атрибут [Display(Name = "Дата найма")] позволяют настроить отображение даты и метку для поля HireDate. Если все сделано правильно, при выполнении приложения модель будет корректно отображаться в представлениях и обрабатываться контроллерами.

Теперь рассмотрим добавление новой сущности Student, которая будет связана с сущностью Instructor через курсы:csharpCopy codenamespace ContosoUniversity.Models

{

public class Student

{

public int StudentID { get; set; }

[Required]

[StringLength(50, ErrorMessage = «Фамилия не должна превышать 50 символов.»)]

public string LastName { get; set; }

[Required]

[StringLength(50, ErrorMessage = «Имя не должно превышать 50 символов.»)]

public string FirstMidName { get; set; }

[DataType(DataType.Date)]

[Display(Name = «Дата зачисления»)]

public DateTime EnrollmentDate { get; set; }

public virtual ICollection Enrollments { get; set; }

}

}

В этой сущности мы используем аналогичные атрибуты для полей LastName и FirstMidName, а также добавляем поле EnrollmentDate для хранения даты зачисления студента. Коллекция Enrollments устанавливает связь с таблицей записей на курсы.

При создании сущностей и их атрибутов важно учитывать требования к данным и сценарии их использования. Внимательное отношение к деталям позволяет создать устойчивую и легко поддерживаемую модель данных, что значительно упрощает дальнейшее развитие и поддержку приложения.

Конфигурация связей через Fluent API

В процессе разработки приложений важно грамотно настраивать связи между сущностями в базе данных. Это позволяет точно следовать бизнес-правилам и обеспечивать целостность данных. Fluent API предоставляет гибкий способ настройки этих связей, обеспечивая полное управление ими без необходимости в изменении структуры самих классов.

Для демонстрации возможностей Fluent API рассмотрим, как можно настроить связи между сущностями Students и Courses. В нашем примере есть множество студентов, которые могут записываться на множество курсов. Эта связь должна быть отражена в базе данных.

Настройка связи в контексте данных

Начнем с создания контекста данных, который будет использоваться для взаимодействия с базой. В данном примере используется соединение с именем basedefaultconnection.

csharpCopy codepublic class SchoolContext : DbContext

{

public SchoolContext() : base(«basedefaultconnection») { }

public DbSet Students { get; set; }

public DbSet Courses { get; set; }

public DbSet Enrollments { get; set; }

protected override void OnModelCreating(DbModelBuilder modelBuilder)

{

modelBuilder.Entity()

.HasMany(s => s.Courses)

.WithMany(c => c.Students)

.Map(cs =>

{

cs.MapLeftKey(«StudentId»);

cs.MapRightKey(«CourseId»);

cs.ToTable(«StudentCourse»);

});

}

}

Конфигурация сущностей

Следующим шагом является настройка самих сущностей. В таблице ниже показаны основные свойства и связи, которые нужно настроить для правильной работы приложения.

Сущность	Свойства	Связи
Student	StudentId (ключ) FirstName (строковое) LastName (строковое) EnrollmentDate (дата)	Courses (многие-ко-многим)
Course	CourseId (ключ) Title (строковое) Credits (целое)	Students (многие-ко-многим)
Enrollment	EnrollmentId (ключ) CourseId (внешний ключ) StudentId (внешний ключ) Grade (целое)	Course Student

Настройка отображения данных

Используя Fluent API, вы можете указать, как должны отображаться данные в базе. Например, можно задать формат отображения даты:csharpCopy codemodelBuilder.Entity()

.Property(s => s.EnrollmentDate)

.HasColumnName(«Enrollment_Date»)

.HasColumnType(«datetime2»)

.HasMaxLength(50)

.HasColumnAnnotation(«Index», new IndexAnnotation(new IndexAttribute(«IX_EnrollmentDate») { IsUnique = true }));

Эти настройки указывают, что колонка должна быть названа «Enrollment_Date», тип данных — datetime2, максимальная длина строки — 50 символов, и она должна быть индексирована.

Преимущества использования Fluent API

Fluent API предоставляет ряд преимуществ, включая гибкость и возможность тонкой настройки бизнес-логики. Он позволяет настроить связи между таблицами базы данных без необходимости в изменении сущностей и методов доступа к данным. Это упрощает поддержку и модификацию структуры базы данных в будущем.

Таким образом, использование Fluent API для настройки связей между сущностями является мощным инструментом в руках разработчика, обеспечивая четкое соблюдение бизнес-правил и целостности данных.

Работа с базой данных

В данном разделе рассматривается, как можно эффективно взаимодействовать с базой данных в контексте вашего веб-приложения. Будут освещены различные подходы и методы, которые помогают не только сохранять данные, но и обеспечивать их целостность и соответствие бизнес-правилам. Внимание будет уделено таким аспектам, как работа с обязательными полями, обработка ошибок, а также техники обновления записей.

Во-первых, важно понимать, что взаимодействие с базой данных требует тщательной настройки моделей и правильного определения ключей и связей между сущностями. Например, указывают обязательные поля с помощью атрибутов, таких как [Required], чтобы избежать проблем с сохранением данных. Также можно использовать атрибуты форматирования, такие как [DataType(DataType.Date)] и [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)], для корректного отображения дат.

Особое внимание следует уделить методу Upsert, который позволяет одновременно обновлять существующие записи и добавлять новые. Это полезно в случаях, когда необходимо синхронизировать данные с внешними источниками. Например, метод AddOrUpdate из библиотеки System.Data.Entity.Migrations является удобным инструментом для таких операций.

Примечание: при работе с методами Upsert важно учитывать наличие уникальных ключей и индексов в базе данных, которые могут вызвать ошибки при попытке вставить дублирующиеся значения.

Для примера, предположим, что у вас имеется таблица с инструкторами и курсами, где каждый инструктор может преподавать несколько курсов. Сущности Instructor и Course связаны через таблицу связей CourseInstructor. При добавлении нового инструктора и назначении ему курсов можно использовать следующий код:

using System.Collections.Generic;
public class SchoolContext : DbContext
{
public DbSet<Instructor> Instructors { get; set; }
public DbSet<Course> Courses { get; set; }
public DbSet<CourseInstructor> CourseInstructors { get; set; }
}
public class Instructor
{
public int InstructorID { get; set; }
public string LastName { get; set; }
public string FirstName { get; set; }
public DateTime HireDate { get; set; }
public virtual ICollection<CourseInstructor> CourseInstructors { get; set; }
}
public class Course
{
public int CourseID { get; set; }
public string Title { get; set; }
public int Credits { get; set; }
public virtual ICollection<CourseInstructor> CourseInstructors { get; set; }
}
public class CourseInstructor
{
public int InstructorID { get; set; }
public int CourseID { get; set; }
public Instructor Instructor { get; set; }
public Course Course { get; set; }
}
public void AddOrUpdateInstructor(SchoolContext context, Instructor instructor, List<int> courseIDs)
{
var existingInstructor = context.Instructors.Include(i => i.CourseInstructors).SingleOrDefault(i => i.InstructorID == instructor.InstructorID);
if (existingInstructor != null)
{
context.Entry(existingInstructor).CurrentValues.SetValues(instructor);
var existingCourseIDs = existingInstructor.CourseInstructors.Select(ci => ci.CourseID).ToList();
foreach (var courseID in courseIDs)
{
if (!existingCourseIDs.Contains(courseID))
{
context.CourseInstructors.Add(new CourseInstructor { InstructorID = instructor.InstructorID, CourseID = courseID });
}
}
}
else
{
instructor.CourseInstructors = courseIDs.Select(courseID => new CourseInstructor { CourseID = courseID }).ToList();
context.Instructors.Add(instructor);
}
context.SaveChanges();
}

Этот код проверяет, существует ли уже данный инструктор в базе данных. Если да, то обновляет его данные и добавляет новые курсы, которые ранее не были назначены. Если нет, то создаёт нового инструктора с указанными курсами.

Таким образом, правильная настройка и работа с базой данных позволяет обеспечить целостность данных, соблюдение бизнес-правил и удобство отрисовки информации для клиента. Надеемся, что данная статья будет полезна для успешного выполнения ваших задач.

Миграции и обновления схемы

При разработке приложений на основе баз данных, часто возникает необходимость в изменении структуры данных по мере развития проекта. Эти изменения могут включать добавление новых таблиц, изменение существующих столбцов, настройку связей между сущностями и многое другое. Для управления этими изменениями и обеспечения их синхронизации с базой данных используются миграции.

Создание миграций

Миграции позволяют автоматически отслеживать изменения в моделях данных и создавать соответствующие инструкции для обновления схемы базы данных. Для этого используется пакет Entity Framework. Ниже приведен пример создания миграции:

add-migration InitialCreate

После выполнения этой команды будет создан файл миграции, в котором указываются все изменения, внесенные в модели данных. Этот файл можно найти в папке Migrations.

Применение миграций

Для применения миграций и обновления схемы базы данных используется команда update-database. Она выполняет все необходимые изменения в базе данных, чтобы синхронизировать её с текущим состоянием моделей данных:

update-database

После выполнения этой команды база данных будет обновлена в соответствии с изменениями, описанными в файлах миграций.

Обновление связей между сущностями

При обновлении схемы базы данных необходимо уделять внимание корректному определению связей между сущностями. Например, при создании связи многие-ко-многим между курсами и студентами (Course и Student) можно использовать следующую модель:

public class Course
{
public int CourseID { get; set; }
public string Title { get; set; }
public int Credits { get; set; }
public virtual ICollection<Student> Students { get; set; }
}
public class Student
{
public int StudentID { get; set; }
public string LastName { get; set; }
public string FirstName { get; set; }
public DateTime EnrollmentDate { get; set; }
public virtual ICollection<Course> Courses { get; set; }
}

Эти классы создают сопоставляемый набор данных, который позволяет управлять связью многие-ко-многим между курсами и студентами. При необходимости изменения этой связи, например добавления нового свойства, достаточно внести изменения в модель и создать новую миграцию.

Особенности автоматических миграций

Автоматические миграции являются полезным инструментом для разработки, так как они позволяют выполнять изменения схемы без создания явных файлов миграций. Для включения автоматических миграций можно использовать следующий код в методе Configuration класса миграций:

internal sealed class Configuration : DbMigrationsConfiguration<ContosoUniversity.Models.SchoolContext>
{
public Configuration()
{
AutomaticMigrationsEnabled = true;
AutomaticMigrationDataLossAllowed = false;
}
protected override void Seed(ContosoUniversity.Models.SchoolContext context)
{
// Seed data
}
}

Включение автоматических миграций позволяет системе автоматически применять изменения в модели данных к базе данных при запуске приложения. Однако следует быть осторожным, так как это может привести к потере данных, если настройки миграций не будут тщательно продуманы.

Обработка ошибок и логирование

При выполнении миграций важно указывать ключи и ограничения, чтобы избежать ошибок. Например, установка атрибута Key для первичных ключей и использование DisplayFormatDataFormatString для форматирования данных могут помочь избежать ошибок и сделать данные более читаемыми.

Также рекомендуется логировать ошибки при выполнении миграций для последующего анализа. Это можно сделать, например, с использованием механизма логирования, встроенного в Entity Framework:

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
modelBuilder.Properties<string>().Configure(p => p.HasColumnType("varchar"));
modelBuilder.Entity<Instructor>()
.ToTable("Instructor")
.HasKey(i => i.ID);
}

В итоге, процесс миграций и обновлений схемы базы данных является важной частью разработки, обеспечивая синхронизацию моделей данных с текущей структурой базы данных и позволяя эффективно управлять изменениями.