6. Bölüm, ASP.NET Core Razor Sayfalarına arama ekleme

Rick Anderson tarafından

Aşağıdaki bölümlerde, filmleri türe veya ada göre arama özelliği eklersiniz.

Aşağıdaki vurgulanmış kodu Pages/MoviePages/Index.cshtml.cs sonrasına ekleyin:

public class IndexModel : PageModel
{
    private readonly RazorPagesMovieContext _context;

    public IndexModel(RazorPagesMovieContext context)
    {
        _context = context;
    }

    public IList<Movie> Movie { get;set; }  = default!;

    [BindProperty(SupportsGet = true)]
    public string? SearchString { get; set; }

    public SelectList? Genres { get; set; }

    [BindProperty(SupportsGet = true)]
    public string? MovieGenre { get; set; }

Önceki kodda:

  • SearchString: Kullanıcıların arama metin kutusuna girdiği metni içerir. SearchString özniteliğine [BindProperty] sahiptir. [BindProperty] özelliğiyle aynı ada sahip form değerlerini ve sorgu dizelerini bağlar. [BindProperty(SupportsGet = true)] HTTP GET isteklerinde bağlama için gereklidir.
  • Genres: Türlerin listesini içerir. Genres kullanıcının listeden bir tür seçmesine izin verir. SelectList gerektirir using Microsoft.AspNetCore.Mvc.Rendering;
  • MovieGenre: Kullanıcının seçtiği türü içerir. Örneğin, "Western".
  • Genres ve MovieGenre bu öğreticinin ilerleyen bölümlerinde kullanılır.

Uyarı

Güvenlik nedeniyle GET istek verilerini sayfa modeli özelliklerine bağlamayı etkinleştirmeniz gerekir. Kullanıcı girişini özelliklere eşlemeden önce doğrulayın. Sorgu dizesi veya yönlendirme değerlerine dayanan senaryoları ele alırken GET bağlamaya dahil olmak yararlı olur.

GET isteklerinde bir özelliği bağlamak için [BindProperty] özniteliğinin SupportsGet özelliğini true olarak ayarlayın:

[BindProperty(SupportsGet = true)]

Daha fazla bilgi için bkz. ASP.NET Core Community Standup: Bind on GET discussion (YouTube).

MoviePages/Index Sayfanın OnGetAsync yöntemini aşağıdaki kodla güncelleştirin:

public async Task OnGetAsync()
{
    var movies = from m in _context.Movie
                 select m;
    if (!string.IsNullOrEmpty(SearchString))
    {
        movies = movies.Where(s => s.Title.Contains(SearchString));
    }

    Movie = await movies.ToListAsync();
}

Yöntemin OnGetAsync ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur:

var movies = from m in _context.Movie
             select m;

Sorgu yalnızca bu noktada tanımlanır . Veritabanında çalıştırılamaz.

SearchString Özellik boş değilse veya var ise, filmler sorgusu arama dizesine göre filtre uygulamak için değiştirilir.

if (!string.IsNullOrEmpty(SearchString))
{
    movies = movies.Where(s => s.Title.Contains(SearchString));
}

Kod s => s.Title.Contains() bir Lambda ifadesidir. Lambda'lar, yöntem tabanlı LINQ sorgularında, Where yöntemi veya gibi standart sorgu işleci yöntemlerine bağımsız değişken olarak kullanılır. LINQ sorguları, tanımladığınızda veya , Whereveya Containsgibi OrderBybir yöntem çağırarak değiştirdiğinizde yürütülemez. Daha ziyade, sorgunun yürütülmesi ertelenir. Bir ifadenin değerlendirmesi, gerçekleştirilen değeri yineleninceye veya ToListAsync yöntemi çağrılana kadar geciktirilir. Daha fazla bilgi için bkz. Sorgu Yürütme.

Not

Contains yöntemi, C# kodunda değil veritabanında çalışır. Sorgudaki büyük/küçük harf duyarlılığı veritabanına ve karşılaştırma kuralına bağlıdır. SQL Server'da, Contains, büyük/küçük harfe duyarsız SQL LIKE ifadesine eşlenir. Varsayılan harmanlama ile SQLite, sorguya bağlı olarak büyük/küçük harfe duyarlı ve büyük/küçük harfe duyarsız bir karışımdır. Büyük/küçük harfe duyarsız SQLite sorguları yapma hakkında bilgi için aşağıdakilere bakın:

MoviePages sayfasına gidin ve URL'ye ?searchString=Ghost gibi bir sorgu dizesi ekleyin. Örneğin, https://localhost:7247/MoviePages?searchString=Ghost. Filtrelenen filmler görüntülenir.

URL'deki arama dizesini ve döndürülen film listesini içeren dizin görünümü.

Dizin sayfasına aşağıdaki yol şablonunu eklerseniz, arama dizesini URL kesimi olarak geçirebilirsiniz. Örneğin, https://localhost:7247/MoviePages/Ghost.

@page "{searchString?}"

Yukarıdaki yol kısıtlaması, başlığın sorgu dizesi değeri yerine rota verileri (URL kesimi) olarak aranmasını sağlar. "{searchString?}" içindeki ?, bunun isteğe bağlı bir yol parametresi olduğu anlamına gelir.

Url'ye hayalet sözcüğünün eklendiği dizin görünümü ve Ghostbusters ve Ghostbusters 2 adlı iki filmin döndürülen film listesi.

ASP.NET Core çalışma zamanı, model binding kullanarak SearchString özelliğinin değerini sorgu dizesinden (?searchString=Ghost) veya yol verilerinden (https://localhost:7247/MoviePages/Ghost) ayarlar. Model bağlama büyük/küçük harfe duyarlı değildir.

Ancak, kullanıcıların film aramak için URL'yi değiştirmesi beklenemez. Bu adımda, filmleri filtrelemek için kullanıcı arabirimi eklersiniz. Yol kısıtlamasını "{searchString?}"eklediyseniz, kaldırın.

Pages/MoviePages/Index.cshtml Dosyayı açın ve aşağıdaki kodda vurgulanan işaretlemeyi ekleyin:

@page
@model RazorPagesMovie.Pages.MoviePages.IndexModel

@{
    ViewData["Title"] = "Index";
}

<h1>Index</h1>

<p>
    <a asp-page="Create">Create New</a>
</p>

<form>
    <p>
        <label>Title: <input type="text" asp-for="SearchString" /></label>
        <input type="submit" value="Filter" />
    </p>
</form>

<table class="table">
    <thead>

HTML <form> etiketi aşağıdaki Etiket Yardımcılarını kullanır:

Değişikliklerinizi kaydedin ve filtreyi test edin.

Başlık filtresi metin kutusuna hayalet sözcüğünün yazıldığı dizin görünümü.

Tarza göre arama

MoviePages/Index.cshtml.cs sayfasının OnGetAsync yöntemini aşağıdaki kodla güncelleştirin:

public async Task OnGetAsync()
{
    // <snippet_search_linqQuery>
    IQueryable<string> genreQuery = from m in _context.Movie
                                    orderby m.Genre
                                    select m.Genre;
    // </snippet_search_linqQuery>

    var movies = from m in _context.Movie
                 select m;

    if (!string.IsNullOrEmpty(SearchString))
    {
        movies = movies.Where(s => s.Title.Contains(SearchString));
    }

    if (!string.IsNullOrEmpty(MovieGenre))
    {
        movies = movies.Where(x => x.Genre == MovieGenre);
    }

    // <snippet_search_selectList>
    Genres = new SelectList(await genreQuery.Distinct().ToListAsync());
    // </snippet_search_selectList>
    Movie = await movies.ToListAsync();
}

Aşağıdaki kod, veritabanından tüm türleri alan bir LINQ sorgusudur.

IQueryable<string> genreQuery = from m in _context.Movie
                                orderby m.Genre
                                select m.Genre;

Türlerin SelectList öğesi, farklı türlerin yansıtılmasıyla oluşturulur:

Genres = new SelectList(await genreQuery.Distinct().ToListAsync());

Razor Sayfasına türe göre arama ekleyin

Index.cshtml <form> öğesini aşağıdaki işaretlemede vurgulandığı gibi güncelleştirin:

@page
@model RazorPagesMovie.Pages.MoviePages.IndexModel

@{
    ViewData["Title"] = "Index";
}

<h1>Index</h1>

<p>
    <a asp-page="Create">Create New</a>
</p>

<form>
    <p>
        <select asp-for="MovieGenre" asp-items="Model.Genres">
            <option value="">All</option>
        </select>
        <label>Title: <input type="text" asp-for="SearchString" /></label>
        <input type="submit" value="Filter" />
    </p>
</form>

Uygulamayı türe göre, film başlığına göre ve her ikisine göre arama yaparak test edin:

Tür seçici ve başlık metin kutusu arama filtresiyle tamamlanmış dizin görünümü.

Sonraki adımlar