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

Bu öğreticide, bir veritabanındaki filmleri yönetmek için sınıflar eklenir. 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ı, üzerinde bağımlılıkları olmadığından POCO sınıfları ("P) olarak bilinir. Veritabanında depolanan verilerin özelliklerini tanımlar.

Veri modeli ekleme

Visual Studio

1. Çözüm Gezgini'da RazorPagesMovie projesiNeni Klasör Ekle'ye> sağ tıklayın. klasörünü Modelsadlandırın.

2. Klasöre Models sağ tıklayın. Sınıf>. Sınıfa Movie adını verin.

3. Sınıfına aşağıdaki özellikleri Movie 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; }
   }
   

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

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

• özniteliği. Bu öznitelikle:

  • Kullanıcının tarih alanına saat bilgilerini girmesi gerekmez.
  • Zaman bilgisi değil, yalnızca tarih görüntülenir.

• Sonrasındaki soru işareti string özelliğin null atanabilir 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.

Sınıfına aşağıdaki özellikleri Movie 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; }
}

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

• ID Veritabanı için birincil anahtar sağlayan alan.

• özniteliği. Bu öznitelikle:

  • Kullanıcının tarih alanına saat bilgilerini girmesi gerekmez.
  • Zaman bilgisi değil, yalnızca tarih görüntülenir.

• Sonrasındaki soru işareti string özelliğin null atanabilir 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ı.
• Için tasarım zamanı araçları EF Core
• EF Core Paketi bağımlılık olarak yükleyen EF Core SQLite sağlayıcısı.
• yapı iskelesi 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 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.

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

Düzenleyici bölgesinin altındaki Panel'de SORUNLAR 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 modelinin iskelesini oluşturma

Bu bölümde, film modeli iskelesi oluşturulmuş. Diğer bir ifadeyle, 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. Sayfalar klasörüne Yeni Klasör>>sağ tıklayın.
   2. Klasöre Filmler adını verin.

2. Sayfalar/Filmler klasörünesağ tıklayın.>

   

3. Yeni İskele Ekle iletişim kutusunda Entity Framework (CRUD)Razor

   

4. Razor kullanarak Sayfa Ekle iletişim kutusunu tamamlayın:

   1. Model sınıfı açılan listesinde Film (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.

   

Dosyaappsettings.json, yerel veritabanına bağlanmak için kullanılan bağlantı dizesi güncelleştirilir.

Visual Studio Code

• proje dizininde ve Program.cs dosyalarını içeren .csproj 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ı dahil kullanılacak sınıf.
-udl	Varsayılan düzeni kullanın.
-outDir	Görünümleri oluşturmak için göreli çıkış klasörü yolu.
--referenceScriptLibraries	Düzenleme ve Oluşturma sayfalarına ekler _ValidationScriptsPartial

Komutla -h ilgili dotnet aspnet-codegenerator razorpage yardım almak için 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ştirmede SQLite bağlantı dizesi ve üretimde SQL Server'ın nasıl seçilip seçilmez olduğunu 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 çağırdığından UseDeveloperExceptionPage geliştirmede çağrı WebApplicationUseDeveloperExceptionPage yapmaz.

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

Oluşturulan dosyalar sonraki öğreticide açıklanmıştır.

İskele işlemi dosyaya aşağıdaki vurgulanmış kodu Program.cs 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();

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();

app.Run();

Değişiklikler Program.cs bu öğreticinin ilerleyen bölümlerinde açıklanmıştır.

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. Veritabanındaki mevcut veriler korunur.

Visual Studio

Bu bölümde, Paket Yöneticisi Konsolu (PMC) penceresi şunları yapmak için kullanılır:

• İlk geçişi ekleyin.

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

• Araçlar menüsünde NuGet Paket Yöneticisi

  

• 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 InitialCreate değişkeni geçişi adlandırmak için kullanılır. Herhangi bir ad kullanılabilir, ancak kurala göre geçişi açıklayan bir ad seçilir.

Sonraki bir adımda ele alınan aşağıdaki uyarı görüntülenir:

'Movie' varlık türündeki 'Price' ondalık sütunu için tür belirtilmedi. Bu, varsayılan duyarlığa ve ölçeklendirmeye uymayan değerlerin sessizce kesilmesine neden olur. 'HasColumnType()' kullanarak tüm değerleri barındırabilecek SQL server sütun türünü açıkça belirtin.

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

  Update-Database
  

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

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. Bağımsız InitialCreate değişken, geçişleri adlandırmak için kullanılır. Herhangi bir ad kullanılabilir, ancak kurala göre geçişi açıklayan bir ad seçilir.

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

  dotnet ef database update
  

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

Note

SQLite için Price , alanın sütun türü olarak TEXTayarlanır. Bu, sonraki bir adımda çözülür.

Veri bağlamı RazorPagesMovieContext:

• Microsoft.EntityFrameworkCore.DbContext'ten 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 geçirilir. 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ıda (/Movies) URL'ye ekleyinhttp://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'.
   

   Geçiş adımını kaçırdınız.

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

   

   Note

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

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

Sonraki öğreticide, yapı iskelesi tarafından oluşturulan dosyalar açıklanmaktadır.

Bağımlılık ekleme ile kaydedilen bağlamı inceleme

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

İskele aracı otomatik olarak bir veritabanı bağlamı oluşturup bağımlılık ekleme kapsayıcısıyla kaydetti. Aşağıdaki vurgulanmış kod, iskele tarafından dosyaya Program.cs 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();

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();

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: yapı iskelesi oluşturulmuş Razor sayfalar