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. Bu öğretici içerikler, kurgusal Contoso Üniversitesi için bir web sitesi oluşturmanızı sağlar. Site öğrenci kabulü, kurs oluşturma ve eğitmen ödevleri gibi işlevleri içerir. Bu öğreticide kod öncelikli yaklaşım kullanılır. Bu öğreticiyi önce veritabanı yaklaşımını kullanarak izlemekle ilgili bilgi için bu Github sorununa bakın.

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

Prerequisites

• Razor Pages kullanmaya yeni başladıysanız, buna başlamadan önce Razor Pages ile çalışmaya başlama eğitim serisini gözden geçirin.

Visual Studio

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

  

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 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.

Troubleshooting

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

Örnek uygulama

Bu eğitimlerde oluşturulan uygulama, basit 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. Bu öğretici, kullanıcı arabirimini nasıl özelleştireceğinize değil, EF Core ASP.NET Core ile nasıl kullanacağınıza odaklanır.

İsteğe bağlı: Örnek indirme paketini oluşturun

Bu adım isteğe bağlıdır. Çözemediğiniz sorunlarla karşılaştığınızda, uygulamanın tamamlanmış sürümünü 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

• SQLiteVersion tanımlı olsun diye ContosoUniversity.csproj dosyasındaki yorumları 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
  
  

Note

Varsayılan olarak, yüklenecek .NET ikili dosyalarının mimarisi şu anda çalışan işletim sistemi mimarisini temsil eder. Farklı bir mimari belirtmek için dotnet tool install nasıl kullanılacağını gözden geçirin. Daha fazla bilgi için bkz. GitHub dotnet/aspnetcore.docs sorunu #29262 - Apple Silicon üzerinde '-a arm64' ekleme.

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 ContosoUniversity girin. 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. sonrakiseç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" ifadesinin geçtiği her yeri "Contoso University" olarak değiştirin. Üç örneği var.
• 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.

Giriş sayfasının göründüğünü doğrulamak 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 ID adlı classnameID bir özelliği birincil anahtar olarak yorumlar. Dolayısıyla, Student sınıfının birincil anahtarı için otomatik olarak tanınan alternatif ad StudentID olur. Daha fazla bilgi için bkz EF Core . - Anahtarlar.

Enrollments özelliği bir gezinti özelliğidir. Gezinme özellikleri, bu varlıkla ilişkili diğer varlıkları içerir. Bu durumda, bir Enrollments varlığın Student ö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ı, StudentID sütunu öğrencinin kimlik numarasını içeriyorsa bir Öğrenci satırıyla ilişkilidir. Örneğin, Bir Öğrenci satırının ID=1 olduğunu varsayalım. İlgili kayıt satırlarında StudentID = 1 olur. StudentID Kayıt tablosundaki bir yabancı anahtardır .

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

Kaydolma 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ıkta tek başına ID yerine classnameID deseni kullanılı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 IDclassname kullanmak, bazı veri modeli değişikliklerinin uygulanmasını kolaylaştırır.

Grade özelliği bir enum'dir. Grade tür bildiriminden sonraki soru işareti, Grade özelliğinin boş değer 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, adı <navigation property name><primary key property name> olan 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 ayrıca <primary key property name> olarak adlandırılabilir. Örneğin, Course varlığının birincil anahtarı CourseID 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.

DatabaseGenerated özniteliği, veritabanının bunu oluşturması 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 Öğretici: Null atanabilir ve null atanamaz başvuru türleriyle tasarım amacınızı daha açık ifade edin konularına bakın.

Null atanabilir başvuru türlerinden kaynaklanan uyarıları ortadan kaldırmak için aşağıdaki satırı ContosoUniversity.csproj dosyasından kaldırın:

<Nullable>enable</Nullable>

Scaffolding altyapısı şu anda boş değer atanabilir başvuru türlerini desteklemediğinden, scaffold işleminde kullanılan modeller de bunları destekleyemez.

Projenin derleyici uyarıları olmadan derlenmesi için, Pages/Error.cshtml.cs içindeki public string? RequestId { get; set; } öğesinden ? null atanabilir başvuru tipi ek açıklamasını kaldırın.

Öğrenci sayfalarını yapılandır

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. Microsoft.EntityFrameworkCore.DbContext sınıfından 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'nde Pages/Students klasörüne sağ tıklayın ve Ekle>Yeni İskeletlenmiş Öğe'yi seçin.
• Yeni İskele Öğesi Ekle iletişim kutusunda:
  • Sol sekmede Yüklü > Ortak >Razor Sayfaları seçin
  • RazorEntity Framework (CRUD) kullanan Sayfalar>ADD seçin.
• Entity Framework Kullanarak Sayfa Ekleme (CRUD) iletişim kutusunda:
  • Model class açılır listesinde Student (ContosoUniversity.Models) seçeneğini belirleyin.
  • Veri bağlamı sınıf satırında (artı) işaretini seçin + .
    • Veri bağlamı adını ContosoUniversityContext yerine SchoolContext ile bitecek şekilde 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.
    • Sayfa Razor Ekle iletişim kutusunu tamamlamak için Ekle'yi seçin.

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
  

  İskele oluşturma için Microsoft.VisualStudio.Web.CodeGeneration.Design paketi 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
  
  

• Student sayfalarını oluşturmak 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 -dbProvider sqlite 
  

  macOS veya Linux'ta

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

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

yapı iskelesi işlemi:

• Pages/Students klasöründe Razor sayfalar oluşturur:
  • 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
• Data/SchoolContext.cs oluşturur.
• Bağlamı, Program.cs içindeki bağımlılık enjeksiyonuna ekler.
• appsettings.json öğesine bir veritabanı bağlantı dizesi ekler.

Veritabanı bağlantı dizesi

Scaffolding aracı, appsettings.json dosyasında 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 C:/Users/<user> dizininde .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.

SchoolContextSQLite bağlantı dizesi anahtarını yeniden adlandırmak, yazarın hem SQLite'ı hem de SQL Server'ı destekleyen tek bir örnek kullanmasına yardımcı olur.

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, Microsoft.EntityFrameworkCore.DbContext'den elde edilir. Bağlam, veri modeline hangi varlıkların dahil olduğunu belirtir. Bu projede sınıfın adı SchoolContext'dır.

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. ile _context.Students.

8 örnek 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:
  • SchoolContext başlatıldıktan sonra, ancak model güvenli hale getirilmeden ve bağlamı başlatmak için kullanılmadan önce çağrılır.
  • Öğreticinin ilerleyen bölümlerinde Student varlığı diğer varlıklara referanslar içereceği 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.

İskele oluşturma aracı, bağlam sınıfını bağımlılık enjeksiyonu kapsayıcısına 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

İskele oluşturucu tarafından eklenen kodun UseSqlite çağrısı yaptığını doğ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ı kullanımı hakkında bilgi için Geliştirme için SQLite'ı, üretim için SQL Server'ı kullanma bölümüne bakın.

Bağlantı dizesinin adı, bir DbContextOptions nesnesi üzerinde bir yöntem çağrılarak bağlama aktarılır. Yerel geliştirme için, ASP.NET Core yapılandırma sistemi bağlantı dizesini appsettings.json veya appsettings.Development.json dosyasından okur.

Veritabanı özel durum filtresini ekleme

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

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, geliştirme ortamında EF geçiş hataları için 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 için bir veritabanı varsa, EnsureCreated yöntemi hiçbir işlem yapmaz. 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.

Eğitim dizisinin ilerleyen bölümlerinde, EnsureCreated tarafından 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.

• Program.cs içinde, DbInitializer.Initialize satırından // öğesini 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.
• Önceden yüklenmiş 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} seçin. Veritabanı adı, daha önce belirtilen bağlam adına bir tire ve bir GUID eklenerek 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 Kodu Görüntüle seçeneğine tıklayarak Student modelinin Student tablo şemasına nasıl eşlendiğini görü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 gerçekleştiğinde, iş parçacıkları serbest kalana 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. Asenkron kodda, bir işlem G/Ç'nin tamamlanmasını beklerken iş parçacığı serbest bırakılır ve sunucunun diğer istekleri işlemek için onu kullanabilmesi sağlanı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, eşzamansız olarak başlatılan işlemle sona erer. İkinci bölüm, işlem tamamlandığında çağrılan bir geri çağırma metoduna yerleştirilir.
• 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 eşzamansız olarak yürütülür. ToListAsyncBuna , , SingleOrDefaultAsyncFirstOrDefaultAsyncve SaveChangesAsyncdahildir. Örneğin var students = context.Students.Where(s => s.LastName == "Davolio") gibi, yalnızca bir IQueryable’yi değiştiren ifadeleri içermez.
• EF Core bağlamı iş parçacığı güvenli değildir: birden fazla işlemi paralel olarak gerçekleştirmeye çalışmayın.
• Eşzamansız kodun performans avantajlarından yararlanmak için, veritabanına sorgu gönderen EF Core yöntemlerini çağırıyorlarsa kitaplık paketlerinin (örneğin sayfalama için olanların) eşzamansızlığı kullandığını doğrulayın.

.NET'te zaman uyumsuz programlama hakkında daha fazla bilgi için Zaman Uyumsuzluğa Genel Bakış ve async ve await ile zaman uyumsuz programlama konularına bakın.

Warning

Microsoft.Data.SqlClient'ın eşzamansız uygulamasının 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.

Performansla ilgili dikkat edilmesi gerekenler

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 listelenmesi sırasında bir veritabanı istisnası oluşursa, kısmen oluşturulmuş bir HTTP 200 yanıtı döndürülebilir.

Sayfalama, eğitimin ilerleyen bölümlerinde ele alınacaktı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 eğitim