Część 6. Dodaj wyszukiwanie do ASP.NET Core Razor Pages

Rick Anderson

W poniższych sekcjach dodasz możliwość wyszukiwania filmów według gatunku lub nazwy.

Dodaj następujący wyróżniony kod do Pages/MoviePages/Index.cshtml.cs:

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; }

W poprzednim kodzie:

  • SearchString: zawiera tekst, który użytkownicy wprowadzają w polu tekstowym wyszukiwania. SearchString ma atrybut [BindProperty]. [BindProperty] Wiąże wartości formularza i ciągi zapytań o tej samej nazwie co właściwość. [BindProperty(SupportsGet = true)] jest wymagany do powiązania w żądaniach HTTP GET.
  • Genres: zawiera listę gatunków. Genres umożliwia użytkownikowi wybranie gatunku z listy. SelectList wymaga using Microsoft.AspNetCore.Mvc.Rendering;
  • MovieGenre: zawiera określony gatunek wybierany przez użytkownika. Na przykład „Western”.
  • Genres i MovieGenre są używane w dalszej części tego samouczka.

Ostrzeżenie

Ze względów bezpieczeństwa należy włączyć powiązanie danych żądania GET z właściwościami modelu strony. Przed mapowaniem danych wejściowych użytkownika na właściwości zweryfikuj je. Włączenie powiązania danych GET jest przydatne w scenariuszach, które wykorzystują parametry ciągu zapytania lub wartości trasy.

Aby powiązać właściwość w żądaniach GET, ustaw właściwość SupportsGet atrybutu [BindProperty] na true:

[BindProperty(SupportsGet = true)]

Aby uzyskać więcej informacji, zobacz ASP.NET Core Community Standup: dyskusja na temat Bind on GET (YouTube).

Zaktualizuj stronę MoviePages/Index metodą OnGetAsync przy użyciu następującego kodu:

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

Pierwszy wiersz OnGetAsync metody tworzy zapytanie LINQ w celu wybrania filmów:

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

Zapytanie jest zdefiniowane tylko w tym momencie. Nie jest ona uruchamiana względem bazy danych.

SearchString Jeśli właściwość null nie jest ustawiona lub jest pusta, zapytanie o filmy jest modyfikowane, aby filtrować według ciągu wyszukiwawczego:

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

Kod s => s.Title.Contains() jest wyrażeniem lambda. Wyrażenia lambda są używane w zapytaniach opartych na LINQ metodach jako argumenty standardowych metod operatorów zapytań, takich jak metoda Where lub Contains. Zapytania LINQ nie są wykonywane podczas ich definiowania lub modyfikowania przez wywołanie metody, takiej jak Where, Containslub OrderBy. Raczej wykonywanie zapytań jest odroczone. Obliczanie wyrażenia jest opóźnione do momentu, aż jego zrealizowana wartość zostanie iterowana lub zostanie wywołana metoda ToListAsync. Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań.

Uwaga

Metoda Contains jest uruchamiana w bazie danych, a nie w kodzie języka C#. Rozróżnianie wielkości liter w zapytaniu zależy od bazy danych i reguł porównywania. W programie SQL Server Contains jest mapowane na SQL LIKE, co jest niewrażliwe na wielkość liter. SQLite z domyślnym sortowaniem jest połączeniem rozróżniania wielkości liter i nierozróżniania wielkości liter, w zależności od zapytania. Aby uzyskać informacje na temat tworzenia zapytań SQLite bez uwzględniania wielkości liter, zobacz następujące kwestie:

Przejdź do strony MoviePages i dołącz ciąg zapytania, taki jak ?searchString=Ghost, do adresu URL. Na przykład https://localhost:7247/MoviePages?searchString=Ghost. Przefiltrowane filmy są wyświetlane.

Widok indeksu z ciągiem wyszukiwania „ghost” w adresie URL i zwróconą listą filmów.

Jeśli dodasz następujący szablon trasy do strony Indeks, możesz przekazać ciąg wyszukiwania jako segment adresu URL. Na przykład https://localhost:7247/MoviePages/Ghost.

@page "{searchString?}"

Powyższe ograniczenie trasy routingu umożliwia wyszukiwanie po tytule jako danych trasy (segment adresu URL) zamiast jako wartości ciągu zapytania. Wartość ? w "{searchString?}" oznacza, że jest to opcjonalny parametr trasy.

Widok indeksu ze słowem ghost dodanym do adresu URL i zwróconą listą filmów o dwóch filmach, Ghostbusters i Ghostbusters 2.

Środowisko uruchomieniowe ASP.NET Core używa wiązania modelu do ustawienia wartości właściwości na podstawie ciągu zapytania () lub danych trasy (). Powiązanie modelu nie uwzględnia wielkości liter.

Nie można jednak oczekiwać zmodyfikowania adresu URL w celu wyszukania filmu. W tym kroku dodasz interfejs użytkownika do filtrowania filmów. Jeśli dodano ograniczenie trasy "{searchString?}", usuń je.

Otwórz plik Pages/MoviePages/Index.cshtml i dodaj znacznik wyróżniony w następującym kodzie:

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

Tag HTML <form> używa następujących pomocników tagów:

Zapisz zmiany i przetestuj filtr.

Widok indeksu ze słowem ghost wpisanym w polu tekstowym Filtr tytułu.

Wyszukiwanie według gatunku

Zaktualizuj metodę strony MoviePages/Index.cshtml.csOnGetAsync przy użyciu następującego kodu:

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

Poniższy kod to zapytanie LINQ, które pobiera wszystkie gatunki z bazy danych.

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

SelectList gatunków jest tworzony przez projekcję odrębnych gatunków:

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

Dodaj wyszukiwanie według gatunku do strony Razor

Zaktualizuj element Index.cshtml<form> element jako wyróżniony w następującym znaczniku:

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

Przetestuj aplikację, wyszukując według gatunku, według tytułu filmu oraz według obu kryteriów:

Widok indeksu wraz z filtrami wyszukiwania selektora gatunku i pola tekstowego Tytuł.

Następne kroki