Dodawanie nowego pola do modelu Movie i tabeli

Autor : Rick Anderson

Uwaga

Zaktualizowana wersja tego samouczka jest dostępna tutaj, która używa ASP.NET MVC 5 i Visual Studio 2013. Jest ona bezpieczniejsza, znacznie prostsza do naśladowania i demonstruje więcej funkcji.

W tej sekcji użyjesz migracje Code First platformy Entity Framework, aby przeprowadzić migrację niektórych zmian do klas modelu, dzięki czemu zmiana zostanie zastosowana do bazy danych.

Domyślnie, gdy używasz programu Entity Framework Code First do automatycznego tworzenia bazy danych, tak jak wcześniej w tym samouczku, program Code First dodaje tabelę do bazy danych, aby ułatwić śledzenie, czy schemat bazy danych jest zsynchronizowany z klasami modelu, z których została wygenerowana. Jeśli nie są one zsynchronizowane, program Entity Framework zgłasza błąd. Ułatwia to śledzenie problemów w czasie programowania, które w przeciwnym razie można znaleźć tylko (przez niejasne błędy) w czasie wykonywania.

Konfigurowanie Migracje Code First zmian modelu

Jeśli używasz programu Visual Studio 2012, kliknij dwukrotnie plik Movies.mdf z Eksplorator rozwiązań, aby otworzyć narzędzie bazy danych. Visual Studio Express dla sieci Web pokaże Eksploratora baz danych, program Visual Studio 2012 wyświetli Eksploratora serwera. Jeśli używasz programu Visual Studio 2010, użyj SQL Server Eksplorator obiektów.

W narzędziu bazy danych (Eksplorator bazy danych, Eksplorator serwera lub SQL Server Eksplorator obiektów) kliknij prawym przyciskiem myszy MovieDBContext i wybierz polecenie Usuń, aby usunąć bazę danych filmów.

Wróć do Eksplorator rozwiązań. Kliknij prawym przyciskiem myszy plik Movies.mdf i wybierz polecenie Usuń , aby usunąć bazę danych filmów.

Skompiluj aplikację, aby upewnić się, że nie ma żadnych błędów.

W menu Narzędzia kliknij pozycję Menedżer pakietów NuGet , a następnie pozycję Konsola menedżera pakietów.

W oknie Konsola menedżera pakietów po wyświetleniu monitu PM> wprowadź wartość "Enable-Migrations -ContextTypeName MvcText.Models.MovieDBContext".

Polecenie Enable-Migrations (pokazane powyżej) tworzy plik Configuration.cs w nowym folderze Migrations .

Program Visual Studio otwiera plik Configuration.cs . Zastąp metodę Seed w pliku Configuration.cs następującym kodem:

protected override void Seed(MvcMovie.Models.MovieDBContext context)
{
    context.Movies.AddOrUpdate( i => i.Title,
        new Movie
        {
            Title = "When Harry Met Sally",
            ReleaseDate = DateTime.Parse("1989-1-11"),
            Genre = "Romantic Comedy",
            Price = 7.99M
        },

         new Movie
         {
             Title = "Ghostbusters ",
             ReleaseDate = DateTime.Parse("1984-3-13"),
             Genre = "Comedy",
             Price = 8.99M
         },

         new Movie
         {
             Title = "Ghostbusters 2",
             ReleaseDate = DateTime.Parse("1986-2-23"),
             Genre = "Comedy",
             Price = 9.99M
         },

       new Movie
       {
           Title = "Rio Bravo",
           ReleaseDate = DateTime.Parse("1959-4-15"),
           Genre = "Western",
           Price = 3.99M
       }
   );
   
}

Kliknij prawym przyciskiem myszy czerwoną falochliwą linię w obszarze Movie , a następnie wybierz pozycję Rozwiąż , a następnie użyj mvcNieuzyskanie.Models;

Spowoduje to dodanie następującej instrukcji using:

using MvcMovie.Models;

Uwaga

Migracje Code First wywołuje metodę Seed po każdej migracji (czyli wywoływanie bazy danych update-database w konsoli menedżera pakietów), a ta metoda aktualizuje wiersze, które zostały już wstawione, lub wstawia je, jeśli jeszcze nie istnieją.

Naciśnij klawisze CTRL-SHIFT-B, aby skompilować projekt.(Poniższe kroki nie powiedzą się, jeśli nie skompiluj w tym momencie).

Następnym krokiem DbMigration jest utworzenie klasy na potrzeby migracji początkowej. Ta migracja w celu utworzenia nowej bazy danych, dlatego plik movie.mdf został usunięty w poprzednim kroku.

W oknie Konsola menedżera pakietów wprowadź polecenie "add-migration Initial", aby utworzyć migrację początkową. Nazwa "Initial" jest dowolna i służy do nazywania utworzonego pliku migracji.

Migracje Code First tworzy inny plik klasy w folderze Migrations (o nazwie {DateStamp}_Initial.cs ), a ta klasa zawiera kod tworzący schemat bazy danych. Nazwa pliku migracji jest wstępnie naprawiona za pomocą znacznika czasu, aby ułatwić zamawianie. Sprawdź plik {DateStamp}_Initial.cs zawierający instrukcje tworzenia tabeli Filmy dla bazy danych Movie DB. Po zaktualizowaniu bazy danych w poniższych instrukcjach ten plik {DateStamp}_Initial.cs zostanie uruchomiony i utworzy schemat bazy danych. Następnie zostanie uruchomiona metoda Seed , aby wypełnić bazę danych danymi testowymi.

W konsoli menedżera pakietów wprowadź polecenie "update-database", aby utworzyć bazę danych i uruchomić metodę Seed .

Jeśli wystąpi błąd wskazujący, że tabela już istnieje i nie można jej utworzyć, prawdopodobnie dlatego, że aplikacja została uruchomiona po usunięciu bazy danych i przed wykonaniem polecenia update-database. W takim przypadku ponownie usuń plik Movies.mdf i spróbuj ponownie wykonać update-database polecenie. Jeśli nadal wystąpi błąd, usuń folder migrations i zawartość, a następnie zacznij od instrukcji w górnej części tej strony (usuń plik Movies.mdf , a następnie przejdź do pozycji Enable-Migrations).

Uruchom aplikację i przejdź do adresu URL /Movies . Zostaną wyświetlone dane inicjujne.

Dodawanie właściwości ratingu do modelu filmowego

Zacznij od dodania nowej Rating właściwości do istniejącej Movie klasy. Otwórz plik Models\Movie.cs i dodaj właściwość podobną do następującej Rating :

public string Rating { get; set; }

Kompletna Movie klasa wygląda teraz jak następujący kod:

public class Movie
{
    public int ID { get; set; }
    public string Title { get; set; }
    public DateTime ReleaseDate { get; set; }
    public string Genre { get; set; }
    public decimal Price { get; set; }
    public string Rating { get; set; }
}

Skompiluj aplikację za pomocą polecenia menu Kompiluj>film lub naciśnij klawisze CTRL-SHIFT-B.

Po zaktualizowaniu Model klasy należy również zaktualizować szablony widoków \Views\Movies\Index.cshtml i \Views\Movies\Create.cshtml , aby wyświetlić nową Rating właściwość w widoku przeglądarki.

Otwórz plik\Views\Movies\Index.cshtml i dodaj <th>Rating</th> nagłówek kolumny tuż po kolumnie Cena . Następnie dodaj kolumnę <td> pod koniec szablonu, aby renderować @item.Rating wartość. Poniżej przedstawiono wygląd zaktualizowanego szablonu widoku Index.cshtml :

@model IEnumerable<MvcMovie.Models.Movie>

@{
    ViewBag.Title = "Index";
}

<h2>Index</h2>

<p>
    @Html.ActionLink("Create New", "Create")
</p>
<table>
    <tr>
        <th>
            @Html.DisplayNameFor(model => model.Title)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.ReleaseDate)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.Genre)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.Price)
        </th>
         <th>
            @Html.DisplayNameFor(model => model.Rating)
        </th>
        <th></th>
    </tr>

@foreach (var item in Model) {
    <tr>
        <td>
            @Html.DisplayFor(modelItem => item.Title)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.ReleaseDate)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.Genre)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.Price)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.Rating)
        </td>
        <td>
            @Html.ActionLink("Edit", "Edit", new { id=item.ID }) |
            @Html.ActionLink("Details", "Details", new { id=item.ID }) |
            @Html.ActionLink("Delete", "Delete", new { id=item.ID })
        </td>
    </tr>
}

</table>

Następnie otwórz plik \Views\Movies\Create.cshtml i dodaj następujący znacznik na końcu formularza. Spowoduje to renderowanie pola tekstowego, aby można było określić ocenę podczas tworzenia nowego filmu.

<div class="editor-label">
    @Html.LabelFor(model => model.Rating)
</div>
<div class="editor-field">
    @Html.EditorFor(model => model.Rating)
    @Html.ValidationMessageFor(model => model.Rating)
</div>

Kod aplikacji został zaktualizowany w celu obsługi nowej Rating właściwości.

Teraz uruchom aplikację i przejdź do adresu URL /Movies . Po wykonaniu tej czynności zobaczysz jednak jeden z następujących błędów:

Ten błąd występuje, ponieważ zaktualizowana Movie klasa modelu w aplikacji różni się teraz od schematu Movie tabeli istniejącej bazy danych. (Nie ma Rating kolumny w tabeli bazy danych).

Istnieje kilka metod rozwiązywania błędu:

1. Program Entity Framework automatycznie upuszcza i ponownie tworzy bazę danych na podstawie nowego schematu klasy modelu. Takie podejście jest bardzo wygodne podczas aktywnego programowania w testowej bazie danych; umożliwia szybkie rozwijanie modelu i schematu bazy danych. Wadą jest jednak utrata istniejących danych w bazie danych — więc nie chcesz używać tej metody w produkcyjnej bazie danych. Używanie inicjatora do automatycznego rozmieszczania bazy danych z danymi testowymi jest często wydajnym sposobem tworzenia aplikacji. Aby uzyskać więcej informacji na temat inicjatorów baz danych platformy Entity Framework, zobacz samouczek platformy ASP.NET MVC/Entity Framework tom Dykstra.
2. Jawnie zmodyfikuj schemat istniejącej bazy danych, tak aby odpowiadał klasom modelu. Zaletą tego podejścia jest przechowywanie danych. Tę zmianę można wprowadzić ręcznie lub tworząc skrypt zmiany bazy danych.
3. Użyj Migracje Code First, aby zaktualizować schemat bazy danych.

Na potrzeby tego samouczka użyjemy Migracje Code First.

Zaktualizuj metodę Seed, aby zapewnić jej wartość dla nowej kolumny. Otwórz plik Migrations\Configuration.cs i dodaj pole Ocena do każdego obiektu Movie.

new Movie
{
    Title = "When Harry Met Sally",
    ReleaseDate = DateTime.Parse("1989-1-11"),
    Genre = "Romantic Comedy",
    Rating = "G",
    Price = 7.99M
},

Skompiluj rozwiązanie, a następnie otwórz okno Konsola menedżera pakietów i wprowadź następujące polecenie:

add-migration AddRatingMig

Polecenie add-migration informuje strukturę migracji, aby zbadać bieżący model filmowy przy użyciu bieżącego schematu bazy danych filmu i utworzyć kod niezbędny do migracji bazy danych do nowego modelu. Element AddRatingMig jest dowolny i służy do nazywania pliku migracji. Warto użyć znaczącej nazwy kroku migracji.

Po zakończeniu tego polecenia program Visual Studio otwiera plik klasy definiujący nową DbMigration klasę pochodną, a w Up metodzie można zobaczyć kod tworzący nową kolumnę.

public partial class AddRatingMig : DbMigration
{
    public override void Up()
    {
        AddColumn("dbo.Movies", "Rating", c => c.String());
    }
    
    public override void Down()
    {
        DropColumn("dbo.Movies", "Rating");
    }
}

Skompiluj rozwiązanie, a następnie wprowadź polecenie "update-database" w oknie Konsola menedżera pakietów .

Na poniższej ilustracji przedstawiono dane wyjściowe w oknie Konsola menedżera pakietów (sygnatura daty dołączana do elementu AddRatingMig będzie inna).

Uruchom ponownie aplikację i przejdź do adresu URL /Movies. Zostanie wyświetlone nowe pole Ocena.

Kliknij link Utwórz nowy , aby dodać nowy film. Pamiętaj, że można dodać ocenę.

Kliknij pozycję Utwórz. Nowy film, w tym ocena, teraz pojawia się na liście filmów:

Należy również dodać Rating pole do szablonów widoku Edytuj, Szczegóły i Indeks wyszukiwania.

Możesz ponownie wprowadzić polecenie "update-database" w oknie Konsoli Menedżera pakietów i nie zostaną wprowadzone żadne zmiany, ponieważ schemat jest zgodny z modelem.

W tej sekcji przedstawiono sposób modyfikowania obiektów modelu i synchronizowania bazy danych ze zmianami. Przedstawiono również sposób wypełniania nowo utworzonej bazy danych przykładowymi danymi, dzięki czemu można wypróbować scenariusze. Następnie przyjrzyjmy się, jak można dodać bogatszą logikę walidacji do klas modeli i umożliwić wymuszanie niektórych reguł biznesowych.

WsteczDalej