第 6 部分，添加搜索 | Microsoft Learn

link之家
链接快照平台
输入网页链接，自动生成快照
标签化管理网页链接
相关文章推荐
热心的西装 · SQLServer之删除视图 - 掘金· 2 年前 ·
玩滑板的啄木鸟 · vue中遍历map的方法 - 百度文库· 2 年前 ·
酒量小的紫菜汤 · typescript史上最强学习入门文章(2 ...· 2 年前 ·
面冷心慈的茶叶 · 防止复制的网页添加“零碎”的方法_CowNe ...· 2 年前 ·
急躁的甜瓜 · Android照片墙应用实现，再多的图片也不 ...· 2 年前 ·
在以下部分中，添加了按流派或名称搜索电影。
将以下突出显示的代码添加到 Pages/Movies/Index.cshtml.cs ：
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
namespace RazorPagesMovie.Pages.Movies
    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; }
在前面的代码中：
SearchString：包含用户在搜索文本框中输入的文本。 SearchString 也有 [BindProperty] 属性。 [BindProperty] 会绑定名称与属性相同的表单值和查询字符串。 在 HTTP GET 请求中进行绑定需要 [BindProperty(SupportsGet = true)]。
Genres：包含流派列表。 Genres 使用户能够从列表中选择一种流派。 SelectList 需要 using Microsoft.AspNetCore.Mvc.Rendering;
MovieGenre：包含用户选择的特定流派。 例如，“Western”。
Genres 和 MovieGenre 会在本教程的后续部分中使用。
出于安全原因，必须选择绑定 GET 请求数据以对模型属性进行分页。 请在将用户输入映射到属性前对其进行验证。 当处理依赖查询字符串或路由值的方案时，选择加入 GET 绑定非常有用。
若要将属性绑定在 GET 请求上，请将 [BindProperty] 特性的 SupportsGet 属性设置为 true：
[BindProperty(SupportsGet = true)]
有关详细信息，请参阅 ASP.NET Core Community Standup：GET 上的绑定讨论 (YouTube) 。
使用以下代码更新索引页面的 OnGetAsync 方法：
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();
OnGetAsync 方法的第一行创建了 LINQ 查询用于选择电影：
// using System.Linq;
var movies = from m in _context.Movie
             select m;
此时仅对查询进行了定义，还没有对数据库运行查询。

如果 SearchString 属性不为 null 或空，则电影查询会修改为根据搜索字符串进行筛选：
if (!string.IsNullOrEmpty(SearchString))
    movies = movies.Where(s => s.Title.Contains(SearchString));
s => s.Title.Contains() 代码是 Lambda 表达式。 Lambda 在基于方法的 LINQ 查询中用作标准查询运算符方法的参数，如 Where 方法或 Contains。 在对 LINQ 查询进行定义或通过调用方法（如 Where、Contains 或 OrderBy）进行修改后，此查询不会执行。 相反，会延迟执行查询。 表达式的计算会延迟，直到循环访问其实现的值或者调用 ToListAsync 方法为止。 有关详细信息，请参阅 Query Execution（查询执行）。
Contains 方法在数据库中运行，而不是在 C# 代码中运行。 查询是否区分大小写取决于数据库和排序规则。 在 SQL Server 上，Contains 映射到 SQL LIKE，这是不区分大小写的。 具有默认排序规则的 SQLite 是区分大小写和不区分大小写的组合，具体取决于查询。 有关进行不区分大小写的 SQLite 查询的信息，请参阅以下内容：

此 GitHub 问题
此 GitHub 问题
排序规则和区分大小写
导航到电影页面，并向 URL 追加一个如 ?searchString=Ghost 的查询字符串。 例如 https://localhost:5001/Movies?searchString=Ghost。 筛选的电影将显示出来。
如果向“索引”页面添加了以下路由模板，搜索字符串则可作为 URL 段传递。 例如 https://localhost:5001/Movies/Ghost。
@page "{searchString?}"
前面的路由约束允许按路由数据（URL 段）搜索标题，而不是按查询字符串值进行搜索。  "{searchString?}" 中的 ? 表示这是可选路由参数。
ASP.NET Core 运行时使用模型绑定，通过查询字符串 (?searchString=Ghost) 或路由数据 (https://localhost:5001/Movies/Ghost) 设置 SearchString 属性的值。 模型绑定不区分大小写。

但是，用户不能通过修改 URL 来搜索电影。 在此步骤中，会添加 UI 来筛选电影。 如果已添加路由约束 "{searchString?}"，请将它删除。
打开 Pages/Movies/Index.cshtml 文件，并添加以下代码中突出显示的标记：
@page
@model RazorPagesMovie.Pages.Movies.IndexModel
    ViewData["Title"] = "Index";
<h1>Index</h1>
    <a asp-page="Create">Create New</a>
        Title: <input type="text" asp-for="SearchString" />
        <input type="submit" value="Filter" />
</form>
<table class="table">
    @*Markup removed for brevity.*@
HTML <form> 标记使用以下标记帮助程序：
表单标记帮助程序。 提交表单时，筛选器字符串将通过查询字符串发送到 Pages/Movies/Index 页面。
输入标记帮助程序
保存更改并测试筛选器。
按流派搜索
使用以下代码更新索引页面的 OnGetAsync 方法：
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();
下面的代码是一种 LINQ 查询，可从数据库中检索所有流派。
// Use LINQ to get list of genres.
IQueryable<string> genreQuery = from m in _context.Movie
                                orderby m.Genre
                                select m.Genre;
流派的 SelectList 是通过投影不包含重复值的流派创建的。
Genres = new SelectList(await genreQuery.Distinct().ToListAsync());
将按流派搜索添加到 Razor 页面
更新 Index.cshtml<form> 元素，如以下标记中突出显示的内容所示：
@page
@model RazorPagesMovie.Pages.Movies.IndexModel
    ViewData["Title"] = "Index";
<h1>Index</h1>
    <a asp-page="Create">Create New</a>
        <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" />
</form>
通过按流派或/和电影标题搜索来测试应用。
上一篇：更新页面下一步：添加新字段
在以下部分中，添加了按流派或名称搜索电影。
将以下突出显示的 using 语句和属性添加到 Pages/Movies/Index.cshtml.cs：
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
namespace RazorPagesMovie.Pages.Movies
    public class IndexModel : PageModel
        private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context;
        public IndexModel(RazorPagesMovie.Data.RazorPagesMovieContext context)
            _context = context;
        public IList<Movie> Movie { get; set; }
        [BindProperty(SupportsGet = true)]
        public string SearchString { get; set; }
        public SelectList Genres { get; set; }
        [BindProperty(SupportsGet = true)]
        public string MovieGenre { get; set; }
在前面的代码中：
SearchString：包含用户在搜索文本框中输入的文本。 SearchString 也有 [BindProperty] 属性。 [BindProperty] 会绑定名称与属性相同的表单值和查询字符串。 在 HTTP GET 请求中进行绑定需要 [BindProperty(SupportsGet = true)]。
Genres：包含流派列表。 Genres 使用户能够从列表中选择一种流派。 SelectList 需要 using Microsoft.AspNetCore.Mvc.Rendering;
MovieGenre：包含用户选择的特定流派。 例如，“Western”。
Genres 和 MovieGenre 会在本教程的后续部分中使用。
出于安全原因，必须选择绑定 GET 请求数据以对模型属性进行分页。 请在将用户输入映射到属性前对其进行验证。 当处理依赖查询字符串或路由值的方案时，选择加入 GET 绑定非常有用。
若要将属性绑定在 GET 请求上，请将 [BindProperty] 特性的 SupportsGet 属性设置为 true：
[BindProperty(SupportsGet = true)]
有关详细信息，请参阅 ASP.NET Core Community Standup：GET 上的绑定讨论 (YouTube) 。
使用以下代码更新索引页面的 OnGetAsync 方法：
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();
OnGetAsync 方法的第一行创建了 LINQ 查询用于选择电影：
// using System.Linq;
var movies = from m in _context.Movie
             select m;
此时仅对查询进行了定义，还没有对数据库运行查询。

如果 SearchString 属性不为 null 或空，则电影查询会修改为根据搜索字符串进行筛选：
if (!string.IsNullOrEmpty(SearchString))
    movies = movies.Where(s => s.Title.Contains(SearchString));
s => s.Title.Contains() 代码是 Lambda 表达式。 Lambda 在基于方法的 LINQ 查询中用作标准查询运算符方法的参数，如 Where 方法或 Contains。 在对 LINQ 查询进行定义或通过调用方法（如 Where、Contains 或 OrderBy）进行修改后，此查询不会执行。 相反，会延迟执行查询。 表达式的计算会延迟，直到循环访问其实现的值或者调用 ToListAsync 方法为止。 有关详细信息，请参阅 Query Execution（查询执行）。
Contains 方法在数据库中运行，而不是在 C# 代码中运行。 查询是否区分大小写取决于数据库和排序规则。 在 SQL Server 上，Contains 映射到 SQL LIKE，这是不区分大小写的。 具有默认排序规则的 SQLite 是区分大小写和不区分大小写的组合，具体取决于查询。 有关进行不区分大小写的 SQLite 查询的信息，请参阅以下内容：

此 GitHub 问题。
此 GitHub 问题
排序规则和区分大小写
导航到电影页面，并向 URL 追加一个如 ?searchString=Ghost 的查询字符串。 例如 https://localhost:5001/Movies?searchString=Ghost。 筛选的电影将显示出来。
如果向“索引”页面添加了以下路由模板，搜索字符串则可作为 URL 段传递。 例如 https://localhost:5001/Movies/Ghost。
@page "{searchString?}"
前面的路由约束允许按路由数据（URL 段）搜索标题，而不是按查询字符串值进行搜索。  "{searchString?}" 中的 ? 表示这是可选路由参数。
ASP.NET Core 运行时使用模型绑定，通过查询字符串 (?searchString=Ghost) 或路由数据 (https://localhost:5001/Movies/Ghost) 设置 SearchString 属性的值。 模型绑定不区分大小写。

但是，用户不能通过修改 URL 来搜索电影。 在此步骤中，会添加 UI 来筛选电影。 如果已添加路由约束 "{searchString?}"，请将它删除。
打开 Pages/Movies/Index.cshtml 文件，并添加以下代码中突出显示的标记：
@page
@model RazorPagesMovie.Pages.Movies.IndexModel
    ViewData["Title"] = "Index";
<h1>Index</h1>
    <a asp-page="Create">Create New</a>
        Title: <input type="text" asp-for="SearchString" />
        <input type="submit" value="Filter" />
</form>
<table class="table">
    @*Markup removed for brevity.*@
HTML <form> 标记使用以下标记帮助程序：
表单标记帮助程序。 提交表单时，筛选器字符串将通过查询字符串发送到 Pages/Movies/Index 页面。
输入标记帮助程序
保存更改并测试筛选器。
按流派搜索
使用以下代码更新索引页面的 OnGetAsync 方法：
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();
下面的代码是一种 LINQ 查询，可从数据库中检索所有流派。
// Use LINQ to get list of genres.
IQueryable<string> genreQuery = from m in _context.Movie
                                orderby m.Genre
                                select m.Genre;
流派的 SelectList 是通过投影不包含重复值的流派创建的。
Genres = new SelectList(await genreQuery.Distinct().ToListAsync());
将按流派搜索添加到 Razor 页面
更新 Index.cshtml<form> 元素，如以下标记中突出显示的内容所示：
@page
@model RazorPagesMovie.Pages.Movies.IndexModel
    ViewData["Title"] = "Index";
<h1>Index</h1>
    <a asp-page="Create">Create New</a>
        <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" />
</form>
<table class="table">
    @*Markup removed for brevity.*@
通过按流派或/和电影标题搜索来测试应用。
上一篇：更新页面下一步：添加新字段