Část 6: Přidání vyhledávání do ASP.NET základních Razor stránek

Autor: Rick Anderson

V následujících částech se přidá hledání filmů podle žánru nebo názvu .

Přidejte následující zvýrazněný kód do Pages/Movies/Index.cshtml.cs:

public class IndexModel : PageModel
{
    private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context;

    public IndexModel(RazorPagesMovie.Data.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; }

V předchozím kódu:

• SearchString: Obsahuje text, který uživatelé zadávají do vyhledávacího textového pole. SearchString[BindProperty] má atribut. [BindProperty] vytvoří vazbu hodnot formuláře a řetězců dotazu se stejným názvem jako vlastnost. [BindProperty(SupportsGet = true)] pro vazbu požadavků HTTP GET se vyžaduje.
• Genres: Obsahuje seznam žánrů. Genres umožňuje uživateli vybrat ze seznamu žánr. SelectList Vyžaduje using Microsoft.AspNetCore.Mvc.Rendering;
• MovieGenre: Obsahuje konkrétní žánr, který uživatel vybere. Například "Západní".
• Genres a MovieGenre používají se později v tomto kurzu.

Upozorňující

Z bezpečnostních důvodů musíte vyjádřit souhlas s vazbou dat požadavků GET na vlastnosti modelu stránky. Před mapováním uživatelského vstupu na vlastnosti tento vstup ověřte. Vyjádření souhlasu s vazbou požadavků GET je užitečné při řešení scénářů, které se spoléhají na řetězec dotazu nebo hodnoty trasy.

Pokud chcete vytvořit vazbu vlastnosti na požadavky GET, nastavte vlastnost SupportsGet atributu [BindProperty] na hodnotu true:

[BindProperty(SupportsGet = true)]

Další informace najdete ve videu Přehled novinek v komunitě ASP.NET Core: Diskuze k vazbě požadavků GET (YouTube).

Aktualizujte metodu indexové stránky OnGetAsync následujícím kódem:

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

První řádek OnGetAsync metody vytvoří dotaz LINQ pro výběr filmů:

// using System.Linq;
var movies = from m in _context.Movie
             select m;

Dotaz je definován pouze v tomto okamžiku, nebyl spuštěn proti databázi.

SearchString Pokud vlastnost není nebo není null prázdná, dotaz filmy se upraví tak, aby filtrovaly hledaný řetězec:

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

Kód s => s.Title.Contains() je výraz lambda. Lambda se používají v dotazech LINQ založených na metodách jako argumenty pro standardní metody operátoru dotazu, jako je metoda Where nebo Contains. Dotazy LINQ se nespouštějí při jejich definování nebo úpravě voláním metody, například Where, Containsnebo OrderBy. Místo toho se odloží provádění dotazu. Vyhodnocení výrazu je zpožděné, dokud jeho dosažená hodnota není iterated over nebo ToListAsync metoda je volána. Další informace najdete v tématu Provádění dotazů.

Poznámka:

Metoda Contains se spouští v databázi, ne v kódu jazyka C#. Citlivost případu na dotazu závisí na databázi a kolaci. Na SQL Serveru Contains se mapuje na SQL LIKE, což je nerozlišující velká a malá písmena. SQLite s výchozí kolací je kombinace rozlišování velkých a malých a velkých písmen v závislosti na dotazu. Informace o rozlišování dotazů SQLite pro případ najdete v následujících tématech:

• Jak používat dotaz bez rozlišování malých a velkých písmen u poskytovatele Sqlite? (dotnet/efcore č. 11414)
• Jak nerozlišovat velká a malá písmena sloupce SQLite (dotnet/AspNetCore.Docs #22314)
• Kolace a citlivost malých a malých písmen

Přejděte na stránku Filmy a připojte řetězec dotazu, například ?searchString=Ghost k adrese URL. Například https://localhost:5001/Movies?searchString=Ghost. Zobrazí se filtrované filmy.

Pokud je na indexovou stránku přidána následující šablona trasy, může být hledaný řetězec předán jako segment adresy URL. Například https://localhost:5001/Movies/Ghost.

@page "{searchString?}"

Předchozí omezení trasy umožňuje prohledávat název jako směrovací data (segment adresy URL) místo jako hodnotu řetězce dotazu. "{searchString?}" Hodnota ? in znamená, že se jedná o volitelný parametr trasy.

Modul runtime ASP.NET Core používá vazbu modelu k nastavení hodnoty SearchString vlastnosti z řetězce dotazu (?searchString=Ghost) nebo směrování dat (https://localhost:5001/Movies/Ghost). Vazba modelu nerozlišuje malá a velká písmena.

Uživatele ale nelze očekávat, že upraví adresu URL tak, aby hledala film. V tomto kroku se uživatelské rozhraní přidá k filtrování filmů. Pokud jste přidali omezení "{searchString?}"trasy, odeberte ho.

Pages/Movies/Index.cshtml Otevřete soubor a přidejte značku zvýrazněnou v následujícím kódu:

@page
@model RazorPagesMovie.Pages.Movies.IndexModel

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

<h1>Index</h1>

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

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

<table class="table">
    @*Markup removed for brevity.*@

Značka HTML <form> používá následující pomocné rutiny značek:

• Pomocná rutina značky formuláře Po odeslání formuláře se řetězec filtru odešle na stránku Pages/Movies/Index prostřednictvím řetězce dotazu.
• Pomocná rutina značky vstupu

Uložte změny a otestujte filtr.

Hledat podle žánru

Aktualizujte metodu Movies/Index.cshtml.cs stránky OnGetAsync následujícím kódem:

public async Task OnGetAsync()
{
    // Use LINQ to get list of genres.
    IQueryable<string> genreQuery = from m in _context.Movie
                                    orderby m.Genre
                                    select m.Genre;

    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);
    }
    Genres = new SelectList(await genreQuery.Distinct().ToListAsync());
    Movie = await movies.ToListAsync();
}

Následující kód je dotaz LINQ, který načte všechny žánry z databáze.

// Use LINQ to get list of genres.
IQueryable<string> genreQuery = from m in _context.Movie
                                orderby m.Genre
                                select m.Genre;

Žánry SelectList se vytvářejí tak, že promítnou různé žánry.

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

Přidání hledání podle žánru Razor na stránku

Index.cshtml<form>Aktualizujte prvek tak, jak je zvýrazněný v následujícím kódu:

@page
@model RazorPagesMovie.Pages.Movies.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>
        Title: <input type="text" asp-for="SearchString" />
        <input type="submit" value="Filter" />
    </p>
</form>

Otestujte aplikaci hledáním podle žánru, podle názvu filmu a obojího.

Další kroky

Předchozí: Aktualizace stránekDalší: Přidání nového pole