Razor ASP.NET Core'da Entity Framework Core içeren sayfalar - Öğretici 1 / 8

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

Bu, ASP.NET Core Razor Pages uygulamasında Entity Framework (EF) Core'un nasıl kullanılacağını gösteren bir dizi öğreticinin ilkidir. Öğreticiler, kurgusal bir Contoso Üniversitesi için bir web sitesi oluşturur. Site öğrenci kabulü, kurs oluşturma ve eğitmen ödevleri gibi işlevleri içerir. Öğreticide ilk olarak kod yaklaşımı kullanılır. Veritabanı ilk yaklaşımını kullanarak bu öğreticiyi izleme hakkında bilgi için bu Github sorununa bakın.

Tamamlanan uygulamayı indirin veya görüntüleyin. İndirme yönergeleri.

Önkoşullar

• Sayfalar'ı kullanmaya yeni başladıysanız, bu sayfayı Razor başlatmadan önce Sayfaları kullanmaya Razor başlama öğretici serisini inceleyin.

Visual Studio

• Visual Studio 2022 ile ASP.NET ve web geliştirme iş yükü.
• .NET 6.0 SDK

Veritabanı altyapıları

Visual Studio yönergelerinde, SQL Server Express'in yalnızca Windows üzerinde çalışan bir sürümü olan SQL Server LocalDB kullanılır.

Visual Studio Code

• Visual Studio Code
• Visual Studio Code için C# (en son sürüm)
• .NET 6.0 SDK

Visual Studio Code yönergelerinde proje oluşturma gibi ASP.NET Core geliştirme işlevleri için .NET CLI kullanılır. macOS, Linux veya Windows'da ve herhangi bir kod düzenleyicisiyle bu yönergeleri izleyebilirsiniz. Visual Studio Code dışında bir araç kullanıyorsanız küçük değişiklikler yapmak gerekebilir.

SQLite için DB Tarayıcısı gibi bir SQLite veritabanını yönetmek ve görüntülemek için bir üçüncü taraf aracı indirip yüklemeyi göz önünde bulundurun.

Veritabanı altyapıları

Visual Studio Code sekmesinde platformlar arası bir veritabanı altyapısı olan SQLite kullanılır.

Sorun giderme

Çözemediğiniz bir sorunla karşılaşırsanız kodunuzu tamamlanmış projeyle karşılaştırın. Yardım almanın iyi bir yolu, ASP.NET Core etiketini veya etiketini kullanarak StackOverflow.com bir soru göndermektirEF Core.

Örnek uygulama

Bu öğreticilerde oluşturulan uygulama, temel bir üniversite web sitesidir. Kullanıcılar öğrenci, kurs ve eğitmen bilgilerini görüntüleyebilir ve güncelleştirebilir. Öğreticide oluşturulan ekranlardan birkaçı aşağıdadır.

Bu sitenin kullanıcı arabirimi stili, yerleşik proje şablonlarını temel alır. Öğreticinin odak noktası, kullanıcı arabiriminin nasıl özelleştirileceği değil ASP.NET Core ile nasıl kullanılacağıdır EF Core .

İsteğe bağlı: Örnek indirmeyi derleme

Bu adım isteğe bağlıdır. Çözemezseniz tamamlanmış uygulamayı derlemeniz önerilir. Çözemediğiniz bir sorunla karşılaşırsanız kodunuzu tamamlanmış projeyle karşılaştırın. İndirme yönergeleri.

Visual Studio

Projeyi açmak için seçin ContosoUniversity.csproj .

• Projeyi derleyin.

• Paket Yöneticisi Konsolu'nda (PMC) aşağıdaki komutu çalıştırın:

  Update-Database
  

Visual Studio Code

• Tanımlandığı şekilde SQLiteVersion dosyadan ContosoUniversity.csproj açıklamaları kaldırın:

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
    <DefineConstants>TRACE;SQLiteVersion</DefineConstants>
  </PropertyGroup>
  

• Komut penceresinde veritabanını güncelleştirin:

  dotnet tool install --global dotnet-ef
  dotnet ef database update
  
  

Not

Varsayılan olarak yüklenecek .NET ikili dosyalarının mimarisi şu anda çalışan işletim sistemi mimarisini temsil eder. Farklı bir işletim sistemi mimarisi belirtmek için bkz . dotnet tool install, --arch option. Daha fazla bilgi için bkz. GitHub sorunu dotnet/AspNetCore.Docs #29262.

Veritabanının tohumunu oluşturmak için projeyi çalıştırın.

Web uygulaması projesi oluşturma

Visual Studio

1. Visual Studio 2022'yi başlatın ve Yeni proje oluştur'u seçin.

   

2. Yeni proje oluştur iletişim kutusunda ASP.NET Core Web App'i ve ardından İleri'yi seçin.

   

3. Yeni projenizi yapılandırın iletişim kutusunda Proje adı için girinContosoUniversity. Projeyi contosoUniversity olarak adlandırmak, büyük harfle eşleştirme de dahil olmak üzere önemlidir, bu nedenle örnek kodu kopyalayıp yapıştırdığınızda ad alanları eşleşecektir.

4. İleri'yi seçin.

5. Ek bilgi iletişim kutusunda .NET 6.0 (uzun süreli destek) öğesini ve ardından Oluştur'u seçin.

   

Visual Studio Code

• Terminalde proje klasörünün oluşturulması gereken klasöre gidin.

• Bir Pages projesi oluşturmak Razor ve cd yeni proje klasörüne eklemek için aşağıdaki komutları çalıştırın:

  dotnet new webapp -o ContosoUniversity
  cd ContosoUniversity  
  

Site stilini ayarlama

Aşağıdaki kodu kopyalayıp dosyaya yapıştırın Pages/Shared/_Layout.cshtml :

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>@ViewData["Title"] - Contoso University</title>
    <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" />
    <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
    <link rel="stylesheet" href="~/ContosoUniversity.styles.css" asp-append-version="true" />
</head>
<body>
    <header>
        <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
            <div class="container">
                <a class="navbar-brand" asp-area="" asp-page="/Index">Contoso University</a>
                <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
                        aria-expanded="false" aria-label="Toggle navigation">
                    <span class="navbar-toggler-icon"></span>
                </button>
                <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
                    <ul class="navbar-nav flex-grow-1">                        
                        <li class="nav-item">
                            <a class="nav-link text-dark" asp-area="" asp-page="/About">About</a>
                        </li>
                        <li class="nav-item">
                            <a class="nav-link text-dark" asp-area="" asp-page="/Students/Index">Students</a>
                        </li>
                        <li class="nav-item">
                            <a class="nav-link text-dark" asp-area="" asp-page="/Courses/Index">Courses</a>
                        </li>
                        <li class="nav-item">
                            <a class="nav-link text-dark" asp-area="" asp-page="/Instructors/Index">Instructors</a>
                        </li>
                        <li class="nav-item">
                            <a class="nav-link text-dark" asp-area="" asp-page="/Departments/Index">Departments</a>
                        </li>
                    </ul>
                </div>
            </div>
        </nav>
    </header>
    <div class="container">
        <main role="main" class="pb-3">
            @RenderBody()
        </main>
    </div>

    <footer class="border-top footer text-muted">
        <div class="container">
            &copy; 2021 - Contoso University - <a asp-area="" asp-page="/Privacy">Privacy</a>
        </div>
    </footer>

    <script src="~/lib/jquery/dist/jquery.js"></script>
    <script src="~/lib/bootstrap/dist/js/bootstrap.bundle.js"></script>
    <script src="~/js/site.js" asp-append-version="true"></script>

    @await RenderSectionAsync("Scripts", required: false)
</body>
</html>

Düzen dosyası site üst bilgisini, alt bilgisini ve menüsünü ayarlar. Yukarıdaki kod aşağıdaki değişiklikleri yapar:

• "ContosoUniversity" öğesinin "Contoso University" olarak her oluşumu. Üç oluşum vardır.
• Home ve Privacy menü girdileri silinir.
• Hakkında, Öğrenciler, Kurslar, Eğitmenler ve Bölümler için girişler eklenir.

içinde Pages/Index.cshtmldosyasının içeriğini aşağıdaki kodla değiştirin:

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="row mb-auto">
    <div class="col-md-4">
        <div class="row no-gutters border mb-4">
            <div class="col p-4 mb-4 ">
                <p class="card-text">
                    Contoso University is a sample application that
                    demonstrates how to use Entity Framework Core in an
                    ASP.NET Core Razor Pages web app.
                </p>
            </div>
        </div>
    </div>
    <div class="col-md-4">
        <div class="row no-gutters border mb-4">
            <div class="col p-4 d-flex flex-column position-static">
                <p class="card-text mb-auto">
                    You can build the application by following the steps in a series of tutorials.
                </p>
                <p>
@*                    <a href="https://docs.microsoft.com/aspnet/core/data/ef-rp/intro" class="stretched-link">See the tutorial</a>
*@                </p>
            </div>
        </div>
    </div>
    <div class="col-md-4">
        <div class="row no-gutters border mb-4">
            <div class="col p-4 d-flex flex-column">
                <p class="card-text mb-auto">
                    You can download the completed project from GitHub.
                </p>
                <p>
@*                    <a href="https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/data/ef-rp/intro/samples" class="stretched-link">See project source code</a>
*@                </p>
            </div>
        </div>
    </div>
</div>

Yukarıdaki kod, ASP.NET Core hakkındaki metni bu uygulamayla ilgili metinle değiştirir.

Sayfanın göründüğünü doğrulamak home için uygulamayı çalıştırın.

Veri modeli

Aşağıdaki bölümlerde bir veri modeli oluşturulur:

Bir öğrenci herhangi bir sayıda kursa kaydolabilir ve bir kursta kayıtlı herhangi bir sayıda öğrenci olabilir.

Student varlığı

• Proje klasöründe bir Models klasörü oluşturun.
• Aşağıdaki kodla oluşturun Models/Student.cs :

  namespace ContosoUniversity.Models
  {
      public class Student
      {
          public int ID { get; set; }
          public string LastName { get; set; }
          public string FirstMidName { get; set; }
          public DateTime EnrollmentDate { get; set; }
  
          public ICollection<Enrollment> Enrollments { get; set; }
      }
  }
  

özelliği, ID veritabanı tablosunun bu sınıfa karşılık gelen birincil anahtar sütunu olur. Varsayılan olarak, EF Core veya classnameID adlı ID bir özelliği birincil anahtar olarak yorumlar. Bu nedenle, sınıf birincil anahtarı için Student alternatif olarak tanınan ad olur StudentID. Daha fazla bilgi için bkz EF Core . - Anahtarlar.

Enrollments özelliği bir gezinti özelliğidir. Gezinti özellikleri, bu varlıkla ilgili diğer varlıkları barındırır. Bu durumda, bir Student varlığın Enrollments özelliği o Öğrenci ile ilgili tüm Enrollment varlıkları barındırır. Örneğin, veritabanındaki bir Öğrenci satırında ilişkili iki Kayıt satırı varsa, Enrollments gezinti özelliği bu iki Kayıt varlığını içerir.

Veritabanında, bir Kayıt satırı, sütunu öğrencinin kimlik değerini içeriyorsa Öğrenci satırıyla StudentID ilişkilidir. Örneğin, Bir Öğrenci satırının ID=1 olduğunu varsayalım. İlgili Kayıt satırları = 1 olacaktır StudentID . StudentID Kayıt tablosundaki bir yabancı anahtardır .

Enrollments özelliği, birden çok ilişkili Kayıt varlığı olabileceğinden olarak ICollection<Enrollment> tanımlanır. veya HashSet<Enrollment>gibi List<Enrollment> diğer koleksiyon türleri kullanılabilir. Kullanıldığında ICollection<Enrollment> , EF Core varsayılan olarak bir HashSet<Enrollment> koleksiyon oluşturur.

Kayıt varlığı

Aşağıdaki kodla oluşturun 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; }
    }
}

EnrollmentID özelliği birincil anahtardır; bu varlık kendi başına değil ID desenini classnameID kullanır. Bir üretim veri modeli için birçok geliştirici tek bir desen seçer ve bunu tutarlı bir şekilde kullanır. Bu öğreticide her ikisinin de çalıştığını göstermek için her ikisi de kullanılır. olmadan ID classname kullanmak, bazı veri modeli değişikliklerinin uygulanmasını kolaylaştırır.

Grade özelliği bir enum'dir. Tür bildiriminden Grade sonraki soru işareti özelliğin Grade null atanabilir olduğunu gösterir. Null olan bir not sıfırdan farklıdır; null, not bilinmediği veya henüz atanmadığı anlamına gelir.

StudentID özelliği bir yabancı anahtardır ve buna karşılık gelen gezinti özelliği şeklindedirStudent. Bir Enrollment varlık tek bir Student varlıkla ilişkilendirildiğinden özelliği tek Student bir varlık içerir.

CourseID özelliği bir yabancı anahtardır ve buna karşılık gelen gezinti özelliği şeklindedirCourse. Bir Enrollment varlık bir Course varlıkla ilişkilendirilir.

EF Core adlı <navigation property name><primary key property name>bir özelliği yabancı anahtar olarak yorumlar. Örneğin,StudentID varlığın birincil anahtarı Student olduğundan gezinti özelliğinin Student yabancı anahtarıdır ID. Yabancı anahtar özellikleri olarak da adlandırılabilir <primary key property name>. Örneğin, CourseID varlığın Course birincil anahtarı olduğundan CourseID.

Kurs varlığı

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

using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Course
    {
        [DatabaseGenerated(DatabaseGeneratedOption.None)]
        public int CourseID { get; set; }
        public string Title { get; set; }
        public int Credits { get; set; }

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

Enrollments özelliği bir gezinti özelliğidir. Bir Course varlık, herhangi bir sayıda Enrollment varlıkla ilişkilendirilebilir.

özniteliği, DatabaseGenerated veritabanının oluşturmasını sağlamak yerine uygulamanın birincil anahtarı belirtmesine olanak tanır.

Uygulamayı oluşturun. Derleyici, değerlerin nasıl null işleneceğini gösteren birkaç uyarı oluşturur. Daha fazla bilgi için bu GitHub sorununa, Null atanabilir başvuru türlerine ve Öğreticiye bakın: Tasarım amacınızı null atanabilir ve null atanamaz başvuru türleriyle daha net ifade edin.

Boş değer atanabilir başvuru türlerindeki uyarıları ortadan kaldırmak için dosyadan ContosoUniversity.csproj aşağıdaki satırı kaldırın:

<Nullable>enable</Nullable>

yapı iskelesi altyapısı şu anda null atanabilir başvuru türlerini desteklemediğinden, iskelede kullanılan modeller de destekleyemez.

? projenin derleyici uyarıları olmadan derlenebilmesi için içindeki Pages/Error.cshtml.cs null atanabilir başvuru türü ek açıklamasını public string? RequestId { get; set; } kaldırın.

yapı iskelesi Öğrenci sayfaları

Bu bölümde, ASP.NET Core iskele aracı şunları oluşturmak için kullanılır:

• Bir EF CoreDbContext sınıf. Bağlam, belirli bir veri modeli için Entity Framework işlevselliğini koordine eden ana sınıftır. sınıfından Microsoft.EntityFrameworkCore.DbContext türetilir.
• Razor varlık için Student Oluşturma, Okuma, Güncelleştirme ve Silme (CRUD) işlemlerini işleyen sayfalar.

Visual Studio

• Sayfalar/Öğrenciler klasörü oluşturun.
• Çözüm Gezgini Sayfalar/Öğrenciler klasörüne sağ tıklayın ve Yeni İskeleli Öğe Ekle'yi>seçin.
• Yeni İskele Öğesi Ekle iletişim kutusunda:
  • Sol sekmede Yüklü OrtakRazor >Sayfalar'ı seçin >
  • Entity Framework (CRUD)ADD kullanan sayfalar'ı> seçin.Razor
• Entity Framework (CRUD) kullanarak Sayfa Ekle Razor iletişim kutusunda:
  • Model sınıfı açılan listesinde Öğrenci (ContosoUniversity.Models) öğesini seçin.
  • Veri bağlamı sınıf satırında (artı) işaretini seçin + .
    • Veri bağlamı adını yerine ContosoUniversityContextile bitecek şekilde SchoolContext değiştirin. Güncelleştirilmiş bağlam adı: ContosoUniversity.Data.SchoolContext
    • Veri bağlamı sınıfını eklemeyi tamamlamak için Ekle'yi seçin.
    • Ekle'yi seçerek Sayfa Ekle Razor iletişim kutusunu tamamlayın.

Aşağıdaki paketler otomatik olarak yüklenir:

• Microsoft.EntityFrameworkCore.SqlServer
• Microsoft.EntityFrameworkCore.Tools
• Microsoft.VisualStudio.Web.CodeGeneration.Design

Visual Studio Code

• Gerekli NuGet paketlerini yüklemek için aşağıdaki .NET CLI komutlarını çalıştırın:

  dotnet add package Microsoft.EntityFrameworkCore.SQLite
  dotnet add package Microsoft.EntityFrameworkCore.SqlServer
  dotnet add package Microsoft.EntityFrameworkCore.Design
  dotnet add package Microsoft.EntityFrameworkCore.Tools
  dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
  dotnet add package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore
  

  Paket Microsoft.VisualStudio.Web.CodeGeneration.Design , yapı iskelesi için gereklidir. Uygulama SQL Server kullanmasa da, yapı iskelesi aracının SQL Server paketine ihtiyacı vardır.

• Sayfalar/Öğrenciler klasörü oluşturun.

• Aspnet-codegenerator iskele aracını yüklemek için aşağıdaki komutu çalıştırın.

  dotnet tool install --global dotnet-aspnet-codegenerator
  
  

• Öğrenci sayfalarının iskelesini yapmak için aşağıdaki komutu çalıştırın.

  Windows'da

  dotnet aspnet-codegenerator razorpage -m Student -dc ContosoUniversity.Data.SchoolContext -udl -outDir Pages\Students --referenceScriptLibraries -sqlite  
  

  macOS veya Linux'ta

  dotnet aspnet-codegenerator razorpage -m Student -dc ContosoUniversity.Data.SchoolContext -udl -outDir Pages/Students --referenceScriptLibraries -sqlite  
  

Önceki adım başarısız olursa projeyi derleyin ve iskele adımını yeniden deneyin.

yapı iskelesi işlemi:

• Sayfalar/Öğrenciler klasöründe sayfalar oluştururRazor:
  • Create.cshtml ve Create.cshtml.cs
  • Delete.cshtml ve Delete.cshtml.cs
  • Details.cshtml ve Details.cshtml.cs
  • Edit.cshtml ve Edit.cshtml.cs
  • Index.cshtml ve Index.cshtml.cs
• oluşturur Data/SchoolContext.cs.
• bağlamını içindeki Program.csbağımlılık eklemeye ekler.
• veritabanı bağlantı dizesi eklerappsettings.json.

Veritabanı bağlantı dizesi

İskele aracı, dosyada appsettings.json bir bağlantı dizesi oluşturur.

Visual Studio

bağlantı dizesi SQL Server LocalDB'yi belirtir:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "SchoolContext": "Server=(localdb)\\mssqllocaldb;Database=SchoolContext-0e9;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

LocalDB, SQL Server Express Veritabanı Altyapısı'nın basit bir sürümüdür ve üretim kullanımına değil uygulama geliştirmeye yöneliktir. Varsayılan olarak, LocalDB dizinde C:/Users/<user> .mdf dosyaları oluşturur.

Visual Studio Code

bağlantı dizesi anahtarını olarak SchoolContextSQLite yeniden adlandırın ve değerini olarak CU.dbkısaltın:

{
  "DetailedErrors": true,
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "ConnectionStrings": {
    "SchoolContextSQLite": "Data Source=CU.db"
  },
  "MyMaxModelBindingCollectionSize": "3"
}

Geçerli olduğundan emin olmadan dizini değiştirmeyin.

Yazarın hem SQLlite hem de SQL Server'ı destekleyen bir örnek korumasına yardımcı olmak için SchoolContextSQLite bağlantı dizesi anahtarını yeniden adlandırma.

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

Belirli bir veri modeli için işlevselliği koordine EF Core eden ana sınıf, veritabanı bağlam sınıfıdır. Bağlam, 'den Microsoft.EntityFrameworkCore.DbContexttüretilir. Bağlam, veri modeline hangi varlıkların dahil olduğunu belirtir. Bu projede sınıfı olarak adlandırılır SchoolContext.

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

using Microsoft.EntityFrameworkCore;
using ContosoUniversity.Models;

namespace ContosoUniversity.Data
{
    public class SchoolContext : DbContext
    {
        public SchoolContext (DbContextOptions<SchoolContext> options)
            : base(options)
        {
        }

        public DbSet<Student> Students { get; set; }
        public DbSet<Enrollment> Enrollments { get; set; }
        public DbSet<Course> Courses { get; set; }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Course>().ToTable("Course");
            modelBuilder.Entity<Enrollment>().ToTable("Enrollment");
            modelBuilder.Entity<Student>().ToTable("Student");
        }
    }
}

Önceki kod tekil DbSet<Student> Student olandan çoğul DbSet<Student> Studentskoda dönüşür. Sayfalar kodunun Razor yeni DBSet adla eşleşmesini sağlamak için aşağıdakilerden genel bir değişiklik yapın: _context.Student. Hedef: _context.Students.

8 oluşum vardır.

Bir varlık kümesi birden çok varlık içerdiğinden, birçok geliştirici özellik adlarının DBSet çoğul olmasını tercih eder.

Vurgulanan kod:

• Her varlık kümesi için bir DbSet<TEntity> özellik oluşturur. Terminolojide EF Core :
  • Varlık kümesi genellikle bir veritabanı tablosuna karşılık gelir.
  • Varlık, tablodaki bir satıra karşılık gelir.
• OnModelCreating çağrısı yapar. OnModelCreating:
  • modelin güvenliği sağlanıp bağlamı başlatmak için kullanılmadan önce çağrılır SchoolContext .
  • Öğreticinin ilerleyen bölümlerinde varlığın Student diğer varlıklara başvuruları olacağı için gereklidir.

Bu sorunu gelecek bir sürümde çözmeyi umuyoruz.

Program.cs

ASP.NET Core, bağımlılık ekleme ile oluşturulur. gibi SchoolContext hizmetler, uygulama başlatma sırasında bağımlılık ekleme ile kaydedilir. Sayfalar gibi Razor bu hizmetleri gerektiren bileşenler, oluşturucu parametreleri aracılığıyla bu hizmetlere sağlanır. Veritabanı bağlam örneğini alan oluşturucu kodu öğreticinin ilerleyen bölümlerinde gösterilir.

yapı iskelesi aracı, bağlam sınıfını bağımlılık ekleme kapsayıcısıyla otomatik olarak kaydetti.

Visual Studio

Aşağıdaki vurgulanan çizgiler iskele tarafından eklendi:

using ContosoUniversity.Data;
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

builder.Services.AddDbContext<SchoolContext>(options =>
  options.UseSqlServer(builder.Configuration.GetConnectionString("SchoolContext")));

Visual Studio Code

yapı iskelesi tarafından eklenen kodun çağrılarını UseSqlitedoğrulayın.

using Microsoft.EntityFrameworkCore;
using ContosoUniversity.Data;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

builder.Services.AddDbContext<SchoolContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("SchoolContextSQLite")));

Üretim veritabanı kullanma hakkında bilgi için bkz . Geliştirme için SQLite kullanma, üretim için SQL Server.

bağlantı dizesi adı, nesne üzerinde bir yöntem DbContextOptions çağrılarak bağlama geçirilir. Yerel geliştirme için ASP.NET Core yapılandırma sistemi veya appsettings.Development.json dosyasından bağlantı dizesi appsettings.json okur.

Veritabanı özel durum filtresini ekleme

Aşağıdaki kodda gösterildiği gibi ve UseMigrationsEndPoint ekleyinAddDatabaseDeveloperPageExceptionFilter:

Visual Studio

using ContosoUniversity.Data;
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

builder.Services.AddDbContext<SchoolContext>(options =>
  options.UseSqlServer(builder.Configuration.GetConnectionString("SchoolContext")));

builder.Services.AddDatabaseDeveloperPageExceptionFilter();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
else
{
    app.UseDeveloperExceptionPage();
    app.UseMigrationsEndPoint();
}

Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore NuGet paketini ekleyin.

NuGet paketini eklemek için Paket Yöneticisi Konsolu'na aşağıdakileri girin:

Install-Package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore

Visual Studio Code

using Microsoft.EntityFrameworkCore;
using ContosoUniversity.Data;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

builder.Services.AddDbContext<SchoolContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("SchoolContextSQLite")));

builder.Services.AddDatabaseDeveloperPageExceptionFilter();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
else
{
    app.UseDeveloperExceptionPage();
    app.UseMigrationsEndPoint();
}

Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore NuGet paketi, Entity Framework Core hata sayfaları için ASP.NET Core ara yazılımı sağlar. Bu ara yazılım, Entity Framework Core geçişleriyle ilgili hataları algılamaya ve tanılamaya yardımcı olur.

, AddDatabaseDeveloperPageExceptionFilter EF geçiş hataları için geliştirme ortamında yararlı hata bilgileri sağlar.

Veritabanını oluşturma

Mevcut değilse veritabanını oluşturmak için güncelleştirin Program.cs :

Visual Studio

using ContosoUniversity.Data;
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

builder.Services.AddDbContext<SchoolContext>(options =>
  options.UseSqlServer(builder.Configuration.GetConnectionString("SchoolContext")));

builder.Services.AddDatabaseDeveloperPageExceptionFilter();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
else
{
    app.UseDeveloperExceptionPage();
    app.UseMigrationsEndPoint();
}

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    var context = services.GetRequiredService<SchoolContext>();
    context.Database.EnsureCreated();
    // DbInitializer.Initialize(context);
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Visual Studio Code

using Microsoft.EntityFrameworkCore;
using ContosoUniversity.Data;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

builder.Services.AddDbContext<SchoolContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("SchoolContextSQLite")));

builder.Services.AddDatabaseDeveloperPageExceptionFilter();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
else
{
    app.UseDeveloperExceptionPage();
    app.UseMigrationsEndPoint();
}

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    var context = services.GetRequiredService<SchoolContext>();
    context.Database.EnsureCreated();
    // DbInitializer.Initialize(context);
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

bağlam EnsureCreated için bir veritabanı varsa yöntemi hiçbir işlem gerçekleştirmez. Veritabanı yoksa, veritabanını ve şemayı oluşturur. EnsureCreated veri modeli değişikliklerini işlemek için aşağıdaki iş akışını etkinleştirir:

• veritabanını silin. Mevcut tüm veriler kaybolur.
• Veri modelini değiştirin. Örneğin, bir EmailAddress alan ekleyin.
• Uygulamayı çalıştırma.
• EnsureCreated yeni şemayla bir veritabanı oluşturur.

Verilerin korunması gerekmediği sürece şema hızla geliştikçe bu iş akışı geliştirmenin erken aşamalarında çalışır. Veritabanına girilen verilerin korunması gerektiğinde durum farklıdır. Bu durumda geçişleri kullanın.

Öğretici serisinin ilerleyen bölümlerinde tarafından EnsureCreated oluşturulan veritabanı silinir ve geçişler kullanılır. tarafından EnsureCreated oluşturulan bir veritabanı, geçişler kullanılarak güncelleştirilemez.

Uygulamayı test etme

• Uygulamayı çalıştırma.
• Öğrenciler bağlantısını ve ardından Yeni Oluştur'u seçin.
• Düzenle, Ayrıntılar ve Sil bağlantılarını test edin.

Veritabanının tohumunu oluşturma

EnsureCreated yöntemi boş bir veritabanı oluşturur. Bu bölüm, veritabanını test verileriyle dolduran kod ekler.

Aşağıdaki kodla oluşturun Data/DbInitializer.cs :

using ContosoUniversity.Models;

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 students = new Student[]
            {
                new Student{FirstMidName="Carson",LastName="Alexander",EnrollmentDate=DateTime.Parse("2019-09-01")},
                new Student{FirstMidName="Meredith",LastName="Alonso",EnrollmentDate=DateTime.Parse("2017-09-01")},
                new Student{FirstMidName="Arturo",LastName="Anand",EnrollmentDate=DateTime.Parse("2018-09-01")},
                new Student{FirstMidName="Gytis",LastName="Barzdukas",EnrollmentDate=DateTime.Parse("2017-09-01")},
                new Student{FirstMidName="Yan",LastName="Li",EnrollmentDate=DateTime.Parse("2017-09-01")},
                new Student{FirstMidName="Peggy",LastName="Justice",EnrollmentDate=DateTime.Parse("2016-09-01")},
                new Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTime.Parse("2018-09-01")},
                new Student{FirstMidName="Nino",LastName="Olivetto",EnrollmentDate=DateTime.Parse("2019-09-01")}
            };

            context.Students.AddRange(students);
            context.SaveChanges();

            var courses = new Course[]
            {
                new Course{CourseID=1050,Title="Chemistry",Credits=3},
                new Course{CourseID=4022,Title="Microeconomics",Credits=3},
                new Course{CourseID=4041,Title="Macroeconomics",Credits=3},
                new Course{CourseID=1045,Title="Calculus",Credits=4},
                new Course{CourseID=3141,Title="Trigonometry",Credits=4},
                new Course{CourseID=2021,Title="Composition",Credits=3},
                new Course{CourseID=2042,Title="Literature",Credits=4}
            };

            context.Courses.AddRange(courses);
            context.SaveChanges();

            var enrollments = new Enrollment[]
            {
                new Enrollment{StudentID=1,CourseID=1050,Grade=Grade.A},
                new Enrollment{StudentID=1,CourseID=4022,Grade=Grade.C},
                new Enrollment{StudentID=1,CourseID=4041,Grade=Grade.B},
                new Enrollment{StudentID=2,CourseID=1045,Grade=Grade.B},
                new Enrollment{StudentID=2,CourseID=3141,Grade=Grade.F},
                new Enrollment{StudentID=2,CourseID=2021,Grade=Grade.F},
                new Enrollment{StudentID=3,CourseID=1050},
                new Enrollment{StudentID=4,CourseID=1050},
                new Enrollment{StudentID=4,CourseID=4022,Grade=Grade.F},
                new Enrollment{StudentID=5,CourseID=4041,Grade=Grade.C},
                new Enrollment{StudentID=6,CourseID=1045},
                new Enrollment{StudentID=7,CourseID=3141,Grade=Grade.A},
            };

            context.Enrollments.AddRange(enrollments);
            context.SaveChanges();
        }
    }
}

Kod, veritabanında öğrenci olup olmadığını denetler. Öğrenci yoksa veritabanına test verileri ekler. Performansı iyileştirmek için koleksiyonlar yerine List<T> dizilerde test verilerini oluşturur.

• içindeProgram.cs, satırından DbInitializer.Initialize kaldırın//:

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    var context = services.GetRequiredService<SchoolContext>();
    context.Database.EnsureCreated();
    DbInitializer.Initialize(context);
}

Visual Studio

• Çalışıyorsa uygulamayı durdurun ve Paket Yöneticisi Konsolu'nda (PMC) aşağıdaki komutu çalıştırın:

  Drop-Database -Confirm
  
  

• veritabanını silmek için ile Y yanıt verin.

Visual Studio Code

• Çalışıyorsa uygulamayı durdurun ve dosyayı silin CU.db .

• Uygulamayı yeniden başlatın.
• Dağıtılan verileri görmek için Öğrenciler sayfasını seçin.

Veritabanını görüntüleme

Visual Studio

• Visual Studio'daki Görünüm menüsünden SQL Server Nesne Gezgini 'yi (SSOX) açın.
• SSOX'ta (localdb)\MSSQLLocalDB > Veritabanları SchoolContext-{GUID} öğesini seçin>. Veritabanı adı, daha önce sağlanan bağlam adından ve bir tire ve GUID'den oluşturulur.
• Tablolar düğümünü genişletin.
• Oluşturulan sütunları ve tabloya eklenen satırları görmek için Öğrenci tablosuna sağ tıklayın ve Verileri Görüntüle'ye tıklayın.
• Student tablosuna sağ tıklayın ve modelin tablo şemasına nasıl Student eşlenip eşlenmediğini görmek için Kodu Görüntüle'ye Student tıklayın.

Visual Studio Code

Veritabanı şemasını ve dağıtılmış verileri görüntülemek için bir SQLite aracı kullanın. Veritabanı dosyası adlandırılır CU.db ve proje klasöründe bulunur.

ASP.NET Core web uygulamalarında zaman uyumsuz EF yöntemleri

Zaman uyumsuz programlama, ASP.NET Core ve EF Coreiçin varsayılan moddur.

Bir web sunucusunun kullanılabilir iş parçacığı sayısı sınırlıdır ve yüksek yük durumlarında tüm kullanılabilir iş parçacıkları kullanımda olabilir. Bu durumda, iş parçacıkları boşaltılana kadar sunucu yeni istekleri işleyemez. Zaman uyumlu kodla, G/Ç'nin tamamlanmasını bekledikleri için iş yapmadıkları sırada birçok iş parçacığı bağlanabilir. Zaman uyumsuz kodla, bir işlem G/Ç'nin tamamlanmasını beklediğinde, iş parçacığı sunucunun diğer istekleri işlemek için kullanması için serbest kalır. Sonuç olarak, zaman uyumsuz kod sunucu kaynaklarının daha verimli kullanılmasını sağlar ve sunucu gecikme olmadan daha fazla trafiği işleyebilir.

Zaman uyumsuz kod, çalışma zamanında az miktarda ek yük getirir. Düşük trafik durumlarında performans isabeti göz ardı edilebilirken, yüksek trafik durumlarında olası performans artışı önemli düzeydedir.

Aşağıdaki kodda , async anahtar sözcüğü, Task dönüş değeri, await anahtar sözcük ve ToListAsync yöntemi kodun zaman uyumsuz olarak yürütülmesini sağlar.

public async Task OnGetAsync()
{
    Students = await _context.Students.ToListAsync();
}

• async anahtar sözcüğü derleyiciye aşağıdakileri söyler:
  • Yöntem gövdesinin bölümleri için geri çağırmalar oluşturun.
  • Döndürülen Task nesnesini oluşturun.
• Task Dönüş türü, devam eden çalışmayı temsil eder.
• await anahtar sözcüğü, derleyicinin yöntemini iki bölüme ayırmasına neden olur. İlk bölüm, zaman uyumsuz olarak başlatılan işlemle sona erer. İkinci bölüm, işlem tamamlandığında çağrılan bir geri çağırma yöntemine konur.
• ToListAsync uzantı yönteminin zaman uyumsuz sürümüdür ToList .

kullanan EF Corezaman uyumsuz kod yazarken dikkat edilmesi gereken bazı şeyler:

• Yalnızca veritabanına sorgu veya komut gönderilmesine neden olan deyimler zaman uyumsuz olarak yürütülür. ToListAsyncBuna , , SingleOrDefaultAsyncFirstOrDefaultAsyncve SaveChangesAsyncdahildir. Gibi yalnızca bir IQueryablevar students = context.Students.Where(s => s.LastName == "Davolio")öğesini değiştiren deyimleri içermez.
• Bağlam EF Core iş parçacığı açısından güvenli değildir: Birden çok işlemi paralel olarak gerçekleştirmeye çalışmayın.
• Zaman uyumsuz kodun performans avantajlarından yararlanmak için, veritabanına sorgu gönderen yöntemleri çağıran EF Core kitaplık paketlerinin (sayfalama gibi) zaman uyumsuz kullandığını doğrulayın.

.NET'te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz . Zaman uyumsuz genel bakış ve zaman uyumsuz programlama ile zaman uyumsuz programlama ve await.

Uyarı

Microsoft.Data.SqlClient'ın zaman uyumsuz uygulamasında bazı bilinen sorunlar vardır (#593, #601 ve diğerleri). Beklenmeyen performans sorunlarıyla karşı karşıyaysanız, özellikle büyük metin veya ikili değerlerle ilgilenirken bunun yerine eşitleme komutu yürütmeyi kullanmayı deneyin.

Performans değerlendirmeleri

Genel olarak, web sayfası rastgele sayıda satır yüklememelidir. Sorguda sayfalama veya sınırlama yaklaşımı kullanılmalıdır. Örneğin, önceki sorgu döndürülen satırları sınırlamak için kullanabilir Take :

public async Task OnGetAsync()
{
    Student = await _context.Students.Take(10).ToListAsync();
}

Bir görünümde büyük bir tablonun numaralandırılması, bir veritabanı özel durumu numaralandırmanın bir parçası olarak gerçekleşirse kısmen leştirilmiş bir HTTP 200 yanıtı döndürebilir.

Disk belleği, öğreticinin ilerleyen bölümlerinde ele alınmıştır.

Daha fazla bilgi için bkz . Performansla ilgili dikkat edilmesi gerekenler (EF).

Sonraki adımlar

Geliştirme için SQLite, üretim için SQL Server kullanma

Sonraki öğretici