2. Bölüm, ASP.NET Core'da Sayfalar uygulamasına Razor model ekleme

Bu öğreticide, veritabanındaki filmleri yönetmek için sınıflar eklersiniz. Uygulamanın model sınıfları, veritabanıyla çalışmak için Entity Framework Core (EF Core) kullanır. EF Core , veri erişimini basitleştiren bir nesne ilişkisel eşleyicidir (O/RM). Önce model sınıflarını yazar ve EF Core veritabanını oluşturur.

Model sınıfları, "Plain-Old CLR Objects" ifadesinden gelen POCO sınıfları olarak bilinir; çünkü EF Core bağımlılıkları yoktur. Veritabanında depolanan verilerin özelliklerini tanımlar.

Veri modeli ekleme

Visual Studio

1. Çözüm Gezgini'ndeRazorPagesMovie projesine sağ tıklayın. Ekle>Yeni Klasör'ü seçin. klasörünü Modelsadlandırın.

2. Klasöre Models sağ tıklayın. Ekle>Sınıf seçeneğini belirleyin. Sınıfa Movie adını verin.

3. Aşağıdaki özellikleri Movie sınıfına ekleyin:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

Movie sınıfı aşağıdakileri içerir:

• Bu ID alan, birincil anahtar için veritabanı tarafından gereklidir.

• [DataType]ReleaseDate özelliğindeki veri türünü belirten bir öznitelik. Bu özniteliği kullanarak:

  • Kullanıcının tarih alanına saat bilgilerini girmesi gerekmez.
  • Herhangi bir zaman bilgisi olmadan yalnızca tarih görüntülenir.

• string sonrasındaki soru işareti, özelliğin null olabilir olduğunu gösterir. Daha fazla bilgi için bkz. Null atanabilir başvuru türleri.

DataAnnotations , sonraki bir öğreticide ele alınmıştır.

Derleme hatası olmadığını doğrulamak için projeyi derleyin.

Visual Studio Code

1. adlı Modelsbir klasör ekleyin.
2. adlı Modelsklasöre Movie.cs bir sınıf ekleyin.

Aşağıdaki özellikleri Movie sınıfına ekleyin:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

Movie sınıfı aşağıdakileri içerir:

• ID Veritabanı için birincil anahtar işlevi gören bir alan.

• Alandaki veri türünü belirten ReleaseDate özniteliği. Bu özniteliği kullanarak:

  • Kullanıcının tarih alanına saat bilgilerini girmesi gerekmez.
  • Herhangi bir zaman bilgisi olmadan yalnızca tarih görüntülenir.

• string sonrasındaki soru işareti, özelliğin null olabilir olduğunu gösterir. Daha fazla bilgi için bkz. Null atanabilir başvuru türleri.

DataAnnotations , sonraki bir öğreticide ele alınmıştır.

NuGet paketleri ve EF araçları ekleme

Aşağıdaki .NET CLI komutlarını çalıştırın:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

Yukarıdaki komutlar aşağıdakileri ekler:

• için komut satırı arabirimi (CLI) araçları EF Core
• Aspnet-codegenerator iskele aracı.
• EF Core için tasarım zamanı araçları
• EF Core paketini bağımlılık olarak yükleyen EF Core SQLite sağlayıcısı.
• İskelet oluşturmak için gereken paketler: Microsoft.VisualStudio.Web.CodeGeneration.Design ve Microsoft.EntityFrameworkCore.SqlServer.

Bir uygulamanın veritabanı bağlamlarını ortama göre yapılandırmasına izin veren birden çok ortam yapılandırmasıyla ilgili yönergeler için bkz. ASP.NET Core çalışma zamanı ortamları.

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.

Visual Studio Code'da, uygulamayı hata ayıklamadan çalıştırmak için Ctrl+F5 basın.

Düzenleyici bölgesinin altındaki Panel'deSORUNLAR sekmesini seçin veya Görünüm menüsünden Şu anda görünümde değilse Sorunlar'ı seçin. Derleme hatası olmadığını doğrulayın.

Film modeli için iskelet oluşturma

Bu bölümde, film modelinin iskelesini oluşturursunuz. Bir iskele aracı, film modeli için Oluşturma, Okuma, Güncelleştirme ve Silme (CRUD) işlemleri için sayfalar oluşturur.

Visual Studio

1. Sayfalar/Filmler klasörünü oluşturun:

   1. Pages klasörüne sağ tıklayın >Ekle>Yeni Klasör.
   2. Klasöre Filmler adını verin.

2. Pages/Movies klasörüne sağ tıklayıp >Add>New Scaffolded Item seçin.

1. Yeni İskelet Ekle iletişim kutusunda RazorEntity Framework Kullanarak Sayfalar (CRUD)>Ekle'yi seçin.

1. Entity Framework Kullanarak Razor Sayfalar Ekleme (CRUD) iletişim kutusunu tamamlayın:

   1. Model sınıfı açılır listesinde Movie (RazorPagesMovie.Models) öğesini seçin.
   2. Veri bağlamı sınıf satırında (artı) işaretini seçin + .
      1. Veri Bağlamı Ekle iletişim kutusunda sınıf adı RazorPagesMovie.Data.RazorPagesMovieContext oluşturulur.
      2. Veritabanı sağlayıcısı açılan listesinde SQL Server'ı seçin.
   3. Add (Ekle) seçeneğini belirleyin.

   

appsettings.json dosyası, yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesiyle güncellenir.

Visual Studio Code

• Program.cs ve .csproj dosyalarını içeren proje dizininde bir komut kabuğu açın. Şu komutu çalıştırın:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Aşağıdaki tabloda ASP.NET Core kod oluşturucu seçenekleri ayrıntıları vermiştir.

Option	Description
-m	Modelin adı.
-dc	DbContext Ad alanı ile birlikte kullanılacak sınıf.
-udl	Varsayılan düzeni kullanın.
-outDir	Görünümlerin oluşturulacağı göreli çıktı klasörü yolu.
--referenceScriptLibraries	_ValidationScriptsPartial Düzenleme ve Oluşturma sayfalarına eklenir

dotnet aspnet-codegenerator razorpage komutu hakkında yardım almak için -h seçeneğini kullanın:

dotnet aspnet-codegenerator razorpage -h

Daha fazla bilgi için bkz . dotnet aspnet-codegenerator.

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

SQLite seçildiğinde, şablon tarafından oluşturulan kod geliştirme için hazırdır. Aşağıdaki kod, geliştirme ortamında SQLite bağlantı dizesinin, üretim ortamında ise SQL Server’ın nasıl seçileceğini gösterir.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Önceki kod, geliştirme modunda WebApplication, UseDeveloperExceptionPage çağırdığı için UseDeveloperExceptionPage çağırmaz.

Warning

Bu makalede, kullanıcının kimliğinin doğrulanması gerekmeyen bir yerel veritabanı kullanılır. Üretim uygulamaları kullanılabilir en güvenli kimlik doğrulama akışını kullanmalıdır. Dağıtılan test ve üretim uygulamaları için kimlik doğrulaması hakkında daha fazla bilgi için bkz . Güvenli kimlik doğrulama akışları.

Oluşturulan ve güncelleştirilen dosyalar

İskele işlemi aşağıdaki dosyaları oluşturur:

• Sayfalar/Filmler: Oluşturma, Silme, Ayrıntılar, Düzenleme ve Dizin oluşturma.
• Data/RazorPagesMovieContext.cs

Sonraki öğreticide, oluşturulan dosyalar açıklanmaktadır.

İskele oluşturma işlemi, aşağıda vurgulanan kodu Program.cs dosyasına ekler:

Visual Studio

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();

app.Run();

Visual Studio Code

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

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

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();
   
app.Run();

Bu öğreticide daha sonra değişiklikler hakkında Program.cs öğreneceksiniz.

EF'nin geçiş özelliğini kullanarak ilk veritabanı şemasını oluşturma

Entity Framework Core'daki geçişler özelliği şunları yapmak için bir yol sağlar:

• İlk veritabanı şemasını oluşturun.
• Veritabanı şemasını uygulamanın veri modeliyle eşitlenmiş durumda tutmak için artımlı olarak güncelleştirin. Bu yaklaşım veritabanındaki mevcut verileri korur.

Visual Studio

Bu bölümde, Paket Yöneticisi Konsolu (PMC) penceresini kullanarak şunları yapın:

• İlk migrasyonu ekleyin.

• Veritabanını ilk geçişle güncelleştirin.

• Araçlar menüsünden NuGet Paket Yöneticisi>Paket Yöneticisi Konsolu'nu seçin.

  

• PMC'de aşağıdaki komutu girin:

  Add-Migration InitialCreate
  

• komutu, Add-Migration ilk veritabanı şemasını oluşturmak için kod oluşturur. Şema, içinde DbContextbelirtilen modeli temel alır. Bağımsız değişken, InitialCreate göçü isimlendirir. Herhangi bir ad kullanabilirsiniz, ancak kurala göre geçişi açıklayan bir ad seçin.

Sonraki bir adımda ele almak istediğiniz aşağıdaki uyarı görüntülenir:

'Movie' varlık türündeki 'Price' ondalık sütunu için hiçbir mağaza türü belirtilmedi. Bu koşul, varsayılan duyarlık ve ölçeklendirmeye uymayan değerlerin sessizce kesilmesine neden olur. 'HasColumnType' kullanarak 'OnModelCreating' içindeki tüm değerleri barındırabilecek SQL server sütun türünü açıkça belirtin, 'HasPrecision' kullanarak duyarlık ve ölçek belirtin veya 'HasConversion' kullanarak bir değer dönüştürücü yapılandırın.

• PMC'de aşağıdaki komutu girin:

  Update-Database
  

  Update-Database komutu, uygulanmayan geçişlerde Up yöntemini çalıştırır. Bu durumda komut, veritabanını oluşturan Up yöntemini Migrations/<time-stamp>_InitialCreate.cs dosyasında çalıştırır.

Visual Studio Code

• RazorPagesMovie.csproj projesine sağ tıklayın ve Tümleşik Terminalde Aç'ı seçin.

  Terminal penceresi, Program.cs ve .csproj dosyalarını içeren proje dizininde komut istemiyle açılır.

• Aşağıdaki .NET CLI komutunu çalıştırın:

  dotnet ef migrations add InitialCreate
  

  komutu, migrations ilk veritabanı şemasını oluşturmak için kod oluşturur. Şema, içinde DbContextbelirtilen modeli temel alır. InitialCreate bağımsız değişkeni, migrasyonları adlandırmak için kullanılır. Herhangi bir adı kullanabilirsiniz, ancak kurala göre geçişi açıklayan bir ad seçin.

• Aşağıdaki .NET CLI komutunu çalıştırın:

  dotnet ef database update
  

  update komutu, uygulanmayan geçişlerde Up yöntemini çalıştırır. Bu durumda, update, veritabanını oluşturan Migrations/<time-stamp>_InitialCreate.cs dosyasındaki Up yöntemini çalıştırır.

Note

SQLite için Price alanın sütun türü olarak TEXTayarlanır. Bu sorun sonraki bir adımda giderilmiştir.

Veri bağlamı RazorPagesMovieContext:

• Microsoft.EntityFrameworkCore.DbContext sınıfından türetilir.
• Veri modeline hangi varlıkların dahil olduğunu belirtir.
• EF Core Model için Oluşturma, Okuma, Güncelleştirme ve Silme gibi işlevleri koordine ederMovie.

RazorPagesMovieContext Oluşturulan dosyadaki Data/RazorPagesMovieContext.cssınıfı:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;

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

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; } = default!;
    }
}

Yukarıdaki kod, varlık kümesi için bir DbSet<Movie> özelliği oluşturur. Entity Framework terminolojisinde bir varlık kümesi genellikle bir veritabanı tablosuna karşılık gelir. Varlık, tablodaki bir satıra karşılık gelir.

Bağlantı dizesi adı, DbContextOptions nesnesinde bir yöntem çağrılarak bağlama iletilir. Yerel geliştirme için Yapılandırma sistemi dosyadan appsettings.json bağlantı dizesi okur.

Uygulamayı test etme

1. Uygulamayı çalıştırın ve tarayıcıdaki URL'nin sonuna /Movies ekleyin (http://localhost:port/movies).

   Aşağıdaki hatayı alırsanız:

   SqlException: Cannot open database "RazorPagesMovieContext-GUID" requested by the login. The login failed.
   Login failed for user 'User-name'.
   

   migrasyon adımını kaçırdınız.

2. Yeni Oluştur bağlantısını test edin.

Note

Price alanına ondalık virgül giremeyebilirsiniz. Ondalık ayırıcı olarak virgül (",") kullanan İngilizce dışındaki yerel ayarlar ve ABD İngilizcesi dışındaki tarih biçimleri için jQuery doğrulamasını desteklemek amacıyla uygulamanın küreselleştirilmesi gerekir. Genelleştirme yönergeleri için bu GitHub sorununa bakın.

1. Düzenle, Ayrıntılar ve Sil bağlantılarını test edin.

Bir sonraki eğitim, iskelet oluşturma ile oluşturulan dosyaları açıklar.

Bağımlılık enjeksiyonu ile kaydedilen bağlamı inceleyin

ASP.NET Core, bağımlılık ekleme ile oluşturulur. Uygulama başlatma sırasında bağımlılık enjeksiyonu ile veritabanı bağlamı gibi EF Core hizmetleri kaydedin. Oluşturucu parametreleri aracılığıyla bu hizmetleri (örneğin Razor Sayfaları) gerektiren bileşenler sağlayın. Veritabanı bağlam örneğini alan oluşturucu kodu öğreticinin ilerleyen bölümlerinde gösterilir.

iskeleleme aracı otomatik olarak bir veritabanı bağlamı oluşturur ve bunu bağımlılık enjeksiyon kapsayıcısıyla kaydeder. Aşağıda vurgulanan kod, oluşturucu tarafından Program.cs dosyasına eklenir:

Visual Studio

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();

app.Run();

Visual Studio Code

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

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

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();
   
app.Run();

Tamamlanan örnekle ilgili sorun giderme

Çözemediğiniz bir sorunla karşılaşırsanız kodunuzu tamamlanmış projeyle karşılaştırın. Tamamlanan projeyi görüntüleme veya indirme (indirme).

Sonraki Adımlar

Önceki: BaşlarkenSonraki: İskeleti Oluşturulmuş Razor Sayfalar