Samouczek: używanie procedur asynchronicznych i składowanych w programie EF w aplikacji MVC ASP.NET

Artykuł
2024-07-16

We wcześniejszych samouczkach przedstawiono sposób odczytywania i aktualizowania danych przy użyciu modelu programowania synchronicznego. W tym samouczku przedstawiono sposób implementowania modelu programowania asynchronicznego. Kod asynchroniczny może pomóc aplikacji w lepszym korzystaniu z zasobów serwera.

W tym samouczku dowiesz się również, jak używać procedur składowanych do operacji wstawiania, aktualizowania i usuwania w jednostce.

Na koniec ponownie wdrożysz aplikację na platformie Azure wraz ze wszystkimi zmianami bazy danych wdrożonym od czasu pierwszego wdrożenia.

Na poniższych ilustracjach przedstawiono niektóre strony, z którymi będziesz pracować.

Strona Działy

Tworzenie działu

W tym samouczku zostały wykonane następujące czynności:

Dowiedz się więcej o kodzie asynchronicznym
Tworzenie kontrolera działu
Korzystanie z procedur składowanych
Wdróż na platformie Azure

Wymagania wstępne

Aktualizowanie powiązanych danych

Dlaczego warto używać kodu asynchronicznego

Serwer internetowy ma ograniczoną liczbę dostępnych wątków, a w sytuacjach dużego obciążenia wszystkie dostępne wątki mogą być używane. W takim przypadku serwer nie może przetworzyć nowych żądań, dopóki wątki nie zostaną zwolnione. W przypadku kodu synchronicznego wiele wątków może być powiązanych, gdy nie wykonują żadnej pracy, ponieważ oczekują na zakończenie operacji we/wy. W przypadku kodu asynchronicznego, gdy proces oczekuje na ukończenie operacji we/wy, jego wątek zostanie zwolniony do użycia przez serwer do przetwarzania innych żądań. W związku z tym kod asynchroniczny umożliwia wydajniejsze wykorzystanie zasobów serwera, a serwer jest włączony do obsługi większej liczby ruchu bez opóźnień.

We wcześniejszych wersjach platformy .NET pisanie i testowanie kodu asynchronicznego było złożone, podatne na błędy i trudne do debugowania. W programie .NET 4.5 pisanie, testowanie i debugowanie kodu asynchronicznego jest o wiele łatwiejsze, ponieważ zwykle należy pisać kod asynchroniczny, chyba że masz powód, aby tego nie robić. Kod asynchroniczny wprowadza niewielką ilość narzutów, ale w przypadku małych sytuacji drogowych trafienie wydajności jest niewielkie, podczas gdy w przypadku dużych sytuacji związanych z ruchem potencjalna poprawa wydajności jest znacząca.

Aby uzyskać więcej informacji na temat programowania asynchronicznego, zobacz Używanie asynchronicznej obsługi asynchronicznej platformy .NET 4.5, aby uniknąć blokowania wywołań.

Tworzenie kontrolera działu

Utwórz kontroler działu w taki sam sposób, jak w przypadku wcześniejszych kontrolerów, z wyjątkiem tego czasu zaznacz pole wyboru Użyj akcji kontrolera asynchronicznego .

Poniższe wyróżnienia pokazują, co zostało dodane do synchronicznego kodu dla Index metody , aby uczynić ją asynchroniczną:

public async Task<ActionResult> Index()
{
    var departments = db.Departments.Include(d => d.Administrator);
    return View(await departments.ToListAsync());
}

Zastosowano cztery zmiany, aby umożliwić wykonywanie asynchronicznego zapytania bazy danych programu Entity Framework:

Metoda jest oznaczona async słowem kluczowym, które nakazuje kompilatorowi generowanie wywołań zwrotnych dla części treści metody i automatyczne tworzenie Task<ActionResult> zwracanego obiektu.
Typ zwracany został zmieniony z ActionResult na Task<ActionResult>. Typ Task<T> reprezentuje bieżącą pracę z wynikiem typu T.
Słowo await kluczowe zostało zastosowane do wywołania usługi internetowej. Gdy kompilator widzi to słowo kluczowe, za kulisami dzieli metodę na dwie części. Pierwsza część kończy się operacją, która jest uruchamiana asynchronicznie. Druga część jest umieszczana w metodzie wywołania zwrotnego wywoływanej po zakończeniu operacji.
Wywołano asynchroniczną wersję ToList metody rozszerzenia.

Dlaczego instrukcja została departments.ToList zmodyfikowana, ale nie instrukcja departments = db.Departments ? Powodem jest to, że tylko instrukcje, które powodują wysyłanie zapytań lub poleceń do bazy danych, są wykonywane asynchronicznie. Instrukcja departments = db.Departments konfiguruje zapytanie, ale zapytanie nie jest wykonywane, dopóki ToList metoda nie zostanie wywołana. W związku z tym tylko ToList metoda jest wykonywana asynchronicznie.

W metodzie Details i HttpGet Edit metodach i Delete metoda jest metodą , Find która powoduje wysłanie zapytania do bazy danych, więc jest to metoda, która jest wykonywana asynchronicznie:

public async Task<ActionResult> Details(int? id)
{
    if (id == null)
    {
        return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
    }
    Department department = await db.Departments.FindAsync(id);
    if (department == null)
    {
        return HttpNotFound();
    }
    return View(department);
}

W metodach Create, HttpPost Editi DeleteConfirmed jest SaveChanges to wywołanie metody, które powoduje wykonanie polecenia, a nie instrukcje, takie jak db.Departments.Add(department) , które powodują modyfikację tylko jednostek w pamięci.

public async Task<ActionResult> Create(Department department)
{
    if (ModelState.IsValid)
    {
        db.Departments.Add(department);
    await db.SaveChangesAsync();
        return RedirectToAction("Index");
    }

Otwórz plik Views\Department\Index.cshtml i zastąp kod szablonu następującym kodem:

@model IEnumerable<ContosoUniversity.Models.Department>
@{
    ViewBag.Title = "Departments";
}
<h2>Departments</h2>
<p>
    @Html.ActionLink("Create New", "Create")
</p>
<table class="table">
    <tr>
        <th>
            @Html.DisplayNameFor(model => model.Name)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.Budget)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.StartDate)
        </th>
    <th>
            Administrator
        </th>
        <th></th>
    </tr>
@foreach (var item in Model) {
    <tr>
        <td>
            @Html.DisplayFor(modelItem => item.Name)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.Budget)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.StartDate)
        </td>
    <td>
            @Html.DisplayFor(modelItem => item.Administrator.FullName)
            </td>
        <td>
            @Html.ActionLink("Edit", "Edit", new { id=item.DepartmentID }) |
            @Html.ActionLink("Details", "Details", new { id=item.DepartmentID }) |
            @Html.ActionLink("Delete", "Delete", new { id=item.DepartmentID })
        </td>
    </tr>
}
</table>

Ten kod zmienia tytuł z Indeks na Działy, przenosi nazwę administratora po prawej stronie i podaje pełną nazwę administratora.

W widokach Tworzenie, Usuwanie, Szczegóły i Edytowanie zmień podpis InstructorID pola na "Administrator" w taki sam sposób, jak zmieniono pole nazwy działu na "Dział" w widokach Kursu.

W widokach Tworzenie i edytowanie użyj następującego kodu:

<label class="control-label col-md-2" for="InstructorID">Administrator</label>

W widokach Usuń i Szczegóły użyj następującego kodu:

<dt>
    Administrator
</dt>

Uruchom aplikację i kliknij kartę Działy .

Wszystko działa tak samo jak w innych kontrolerach, ale w tym kontrolerze wszystkie zapytania SQL są wykonywane asynchronicznie.

Niektóre kwestie, które należy wziąć pod uwagę podczas korzystania z programowania asynchronicznego w programie Entity Framework:

Kod asynchroniczny nie jest bezpieczny wątkiem. Innymi słowy, nie próbuj wykonywać wielu operacji równolegle przy użyciu tego samego wystąpienia kontekstu.
Jeśli chcesz skorzystać z zalet wydajności kodu asynchronicznego, upewnij się, że wszystkie używane pakiety bibliotek (takie jak na potrzeby stronicowania), należy również użyć asynchronicznego, jeśli wywołują one dowolne metody programu Entity Framework, które powodują wysyłanie zapytań do bazy danych.

Korzystanie z procedur składowanych

Niektórzy deweloperzy i administratorzy baz danych wolą używać procedur składowanych na potrzeby dostępu do bazy danych. We wcześniejszych wersjach programu Entity Framework można pobrać dane przy użyciu procedury składowanej, wykonując nieprzetworzone zapytanie SQL, ale nie można poinstruować platformy EF, aby korzystała z procedur składowanych na potrzeby operacji aktualizacji. W programie EF 6 można łatwo skonfigurować metodę Code First do używania procedur składowanych.

W dal\SchoolContext.cs dodaj wyróżniony kod do OnModelCreating metody .

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
    modelBuilder.Entity<Course>()
        .HasMany(c => c.Instructors).WithMany(i => i.Courses)
        .Map(t => t.MapLeftKey("CourseID")
            .MapRightKey("InstructorID")
            .ToTable("CourseInstructor"));
    modelBuilder.Entity<Department>().MapToStoredProcedures();
}

Ten kod instruuje program Entity Framework, aby używał procedur składowanych do operacji wstawiania, aktualizowania i usuwania w jednostce Department .

W konsoli zarządzania pakietami wprowadź następujące polecenie:

add-migration DepartmentSP

Otwórz plik Migrations\<timestamp>_DepartmentSP.cs aby wyświetlić kod w Up metodzie, która tworzy procedury składowane Insert, Update i Delete:

public override void Up()
{
    CreateStoredProcedure(
        "dbo.Department_Insert",
        p => new
            {
                Name = p.String(maxLength: 50),
                Budget = p.Decimal(precision: 19, scale: 4, storeType: "money"),
                StartDate = p.DateTime(),
                InstructorID = p.Int(),
            },
        body:
            @"INSERT [dbo].[Department]([Name], [Budget], [StartDate], [InstructorID])
              VALUES (@Name, @Budget, @StartDate, @InstructorID)
              
              DECLARE @DepartmentID int
              SELECT @DepartmentID = [DepartmentID]
              FROM [dbo].[Department]
              WHERE @@ROWCOUNT > 0 AND [DepartmentID] = scope_identity()
              
              SELECT t0.[DepartmentID]
              FROM [dbo].[Department] AS t0
              WHERE @@ROWCOUNT > 0 AND t0.[DepartmentID] = @DepartmentID"
    );
    
    CreateStoredProcedure(
        "dbo.Department_Update",
        p => new
            {
                DepartmentID = p.Int(),
                Name = p.String(maxLength: 50),
                Budget = p.Decimal(precision: 19, scale: 4, storeType: "money"),
                StartDate = p.DateTime(),
                InstructorID = p.Int(),
            },
        body:
            @"UPDATE [dbo].[Department]
              SET [Name] = @Name, [Budget] = @Budget, [StartDate] = @StartDate, [InstructorID] = @InstructorID
              WHERE ([DepartmentID] = @DepartmentID)"
    );
    
    CreateStoredProcedure(
        "dbo.Department_Delete",
        p => new
            {
                DepartmentID = p.Int(),
            },
        body:
            @"DELETE [dbo].[Department]
              WHERE ([DepartmentID] = @DepartmentID)"
    );    
}

W konsoli zarządzania pakietami wprowadź następujące polecenie:

update-database
Uruchom aplikację w trybie debugowania, kliknij kartę Działy , a następnie kliknij pozycję Utwórz nowy.
Wprowadź dane dla nowego działu, a następnie kliknij przycisk Utwórz.
W programie Visual Studio przyjrzyj się dziennikom w oknie Dane wyjściowe , aby zobaczyć, że procedura składowana została użyta do wstawienia nowego wiersza Dział.

Code First tworzy domyślne nazwy procedur składowanej. Jeśli używasz istniejącej bazy danych, może być konieczne dostosowanie nazw procedur składowanych w celu użycia procedur składowanych zdefiniowanych już w bazie danych. Aby uzyskać informacje o tym, jak to zrobić, zobacz Entity Framework Code First Insert/Update/Delete Stored Procedures (Procedury składowane w programie Entity Framework Code First Insert/Update/Delete).

Jeśli chcesz dostosować wygenerowane procedury składowane, możesz edytować szkielet kodu dla metody migracji Up , która tworzy procedurę składowaną. Dzięki temu zmiany są odzwierciedlane za każdym razem, gdy migracja zostanie uruchomiona i zostanie zastosowana do produkcyjnej bazy danych, gdy migracje są uruchamiane automatycznie w środowisku produkcyjnym po wdrożeniu.

Jeśli chcesz zmienić istniejącą procedurę składowaną utworzoną w poprzedniej migracji, możesz użyć polecenia Add-Migration, aby wygenerować pustą migrację, a następnie ręcznie napisać kod, który wywołuje metodę AlterStoredProcedure .

Wdróż na platformie Azure

Ta sekcja wymaga ukończenia opcjonalnej sekcji Wdrażanie aplikacji na platformie Azure w samouczku Migracje i wdrażanie tej serii. Jeśli wystąpiły błędy migracji, które rozwiązano przez usunięcie bazy danych w projekcie lokalnym, pomiń tę sekcję.

W programie Visual Studio kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań i wybierz polecenie Publikuj z menu kontekstowego.
Kliknij przycisk Publikuj.

Program Visual Studio wdraża aplikację na platformie Azure, a aplikacja zostanie otwarta w domyślnej przeglądarce uruchomionej na platformie Azure.
Przetestuj aplikację, aby sprawdzić, czy działa.

Przy pierwszym uruchomieniu strony, która uzyskuje dostęp do bazy danych, program Entity Framework uruchamia wszystkie metody migracji Up wymagane do zapewnienia aktualności bazy danych z bieżącym modelem danych. Teraz możesz używać wszystkich dodanych stron sieci Web od czasu ostatniego wdrożenia, w tym stron działu dodanych w tym samouczku.

Uzyskiwanie kodu

Pobieranie ukończonego projektu

Dodatkowe zasoby

Linki do innych zasobów programu Entity Framework można znaleźć w ASP.NET Dostęp do danych — zalecane zasoby.

Następne kroki

W tym samouczku zostały wykonane następujące czynności:

Informacje o kodzie asynchronicznym
Tworzenie kontrolera działu
Używane procedury składowane
Wdrożone na platformie Azure

Przejdź do następnego artykułu, aby dowiedzieć się, jak obsługiwać konflikty, gdy wielu użytkowników aktualizuje tę samą jednostkę w tym samym czasie.

Obsługa współbieżności

Udostępnij za pośrednictwem

Samouczek: używanie procedur asynchronicznych i składowanych w programie EF w aplikacji MVC ASP.NET

Wymagania wstępne

Dlaczego warto używać kodu asynchronicznego

Tworzenie kontrolera działu

Korzystanie z procedur składowanych

Wdróż na platformie Azure

Uzyskiwanie kodu

Dodatkowe zasoby

Następne kroki

Opinia

Dodatkowe zasoby