教程：使用 .NET SDK 对搜索结果排序

项目
01/26/2021

在本教程系列中，结果已返回并按默认顺序显示。在本教程中，你将添加主要和次要排序条件。除了根据数值进行排序，最后一个示例还介绍了如何根据自定义计分概要文件对结果进行排序。我们还将再深入一些探讨复杂类型的显示。

在本教程中，你将了解如何执行以下操作：

根据一个属性对结果排序
根据多个属性对结果排序
根据计分概要文件对结果排序

概述

本教程扩展在为搜索结果添加分页功能教程中创建的无限滚动项目。

本教程中的代码完成版本可以在以下项目中找到：

5-order-results (GitHub)

先决条件

2b-add-infinite-scroll (GitHub) 解决方案。该项目可使用在上一教程中生成的版本，或 GitHub 中的副本。

根据一个属性对结果排序

根据一个属性（比如酒店评级）对结果排序时，我们不仅需要已排序的结果，还需要确保排序正确。通过将评级字段添加到结果，我们可以确保结果排序正确。

在本练习中，我们还将对结果的显示添加一些要素：每家酒店的最低房价和最贵房价。

无需修改任何模型即可实现排序。仅视图和控制器需要更新。首先打开主控制器。

向搜索参数添加 OrderBy 属性

在 HomeController.cs 中，添加 OrderBy 选项，并包含 Rating 属性（按降序顺序排序）。在 Index(SearchData model) 方法中，向搜索参数添加以下行。
```
options.OrderBy.Add("Rating desc");
```
注意

默认顺序为升序，但可向属性添加 asc 来明确这一点。降序排序通过添加 desc 进行指定。
现在运行应用，再输入任意常见搜索词。不清楚结果是否按正确顺序显示，因为你（开发人员）和用户都没法轻易验证结果！

让我们来明确结果是按评级进行排序的。首先，将 hotels.css 文件中的 box1 和 box2 类替换为以下类（这些类是我们需要用于此教程的所有新类）。

textarea.box1A {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 14pt;
    color: blue;
    padding-left: 5px;
    text-align: left;
}

textarea.box1B {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 14pt;
    color: blue;
    text-align: right;
    padding-right: 5px;
}

textarea.box2A {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 12pt;
    color: blue;
    padding-left: 5px;
    text-align: left;
}

textarea.box2B {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 12pt;
    color: blue;
    text-align: right;
    padding-right: 5px;
}

textarea.box3 {
    width: 648px;
    height: 100px;
    border: none;
    background-color: azure;
    font-size: 12pt;
    padding-left: 5px;
    margin-bottom: 24px;
}

提示

浏览器通常会缓存 css 文件，而这可能导致使用旧的 css 文件，忽略你编辑的内容。要解决此问题的一个好方法是，向链接添加一个具有版本参数的查询字符串。例如：

  <link rel="stylesheet" href="~/css/hotels.css?v1.1" />

如果你认为浏览器正在使用旧式 css 文件，请更新版本号。

在 Index(SearchData model) 方法中，向 Select 参数添加 Rating 属性，以便结果包含以下三个字段：
```
options.Select.Add("HotelName");
options.Select.Add("Description");
options.Select.Add("Rating");
```

打开视图 (index.cshtml)，将呈现循环 () 替换为以下代码。

<!-- Show the hotel data. -->
@for (var i = 0; i < result.Count; i++)
{
    var ratingText = $"Rating: {result[i].Document.Rating}";

    // Display the hotel details.
    @Html.TextArea($"name{i}", result[i].Document.HotelName, new { @class = "box1A" })
    @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
    @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
}

需要能在所显示的第一个页面以及通过无限滚动调用的后续页面中进行评级。对于这两种情况的后一种情况，我们需要更新控制器中的 Next 操作，还需要更新 scrolled 函数。首先从控制器开始，将 Next 方法更改为以下代码。此代码会创建并传递评级文本。

public async Task<ActionResult> Next(SearchData model)
{
    // Set the next page setting, and call the Index(model) action.
    model.paging = "next";
    await Index(model);

    // Create an empty list.
    var nextHotels = new List<string>();

    // Add a hotel details to the list.
    await foreach (var result in model.resultList.GetResultsAsync())
    {
        var ratingText = $"Rating: {result.Document.Rating}";
        var rateText = $"Rates from ${result.Document.cheapest} to ${result.Document.expensive}";

        string fullDescription = result.Document.Description;

        // Add strings to the list.
        nextHotels.Add(result.Document.HotelName);
        nextHotels.Add(ratingText);
        nextHotels.Add(fullDescription);
    }

    // Rather than return a view, return the list of data.
    return new JsonResult(nextHotels);
}

接下来，更新视图中的 scrolled 函数来显示评级文本。

<script>
    function scrolled() {
        if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
            $.getJSON("/Home/Next", function (data) {
                var div = document.getElementById('myDiv');

                // Append the returned data to the current list of hotels.
                for (var i = 0; i < data.length; i += 3) {
                    div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box1B">' + data[i + 1] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box3">' + data[i + 2] + '</textarea>';
                }
            });
        }
    }
</script>

然后，再次运行应用。搜索任意常见词（例如“wifi”），并验证结果是否按酒店评级降序进行排序。

你将注意到多家酒店的评级相同，因此它们在显示结果中的顺序又是找到数据的顺序（即任意顺序）。

在探讨第二层排序的添加之前，让我们来添加一些代码，显示客房评级的范围。我们将添加此代码，同时显示来自复杂类型的提取数据；也正因如此，我们能探讨根据房价进行的结果排序（可能是最低房价排第一）。

向视图添加房价范围

向 Hotel.cs 模型添加包含最低房价和最高房价的属性。

// Room rate range
public double cheapest { get; set; }
public double expensive { get; set; }

在主控制器中，在 Index(SearchData model) 操作结束时计算房价。在存储临时数据后添加计算结果。

// Ensure TempData is stored for the next call.
TempData["page"] = page;
TempData["searchfor"] = model.searchText;

// Calculate the room rate ranges.
await foreach (var result in model.resultList.GetResultsAsync())
{
    var cheapest = 0d;
    var expensive = 0d;

    foreach (var room in result.Document.Rooms)
    {
        var rate = room.BaseRate;
        if (rate < cheapest || cheapest == 0)
        {
            cheapest = (double)rate;
        }
        if (rate > expensive)
        {
            expensive = (double)rate;
        }
    }
    model.resultList.Results[n].Document.cheapest = cheapest;
    model.resultList.Results[n].Document.expensive = expensive;
}

在控制器的 Index(SearchData model) 操作方法中，向 Select 参数添加 Rooms 属性。
```
options.Select.Add("Rooms");
```

更改视图中的呈现循环，显示第一个结果页面的房价范围。

<!-- Show the hotel data. -->
@for (var i = 0; i < result.Count; i++)
{
    var rateText = $"Rates from ${result[i].Document.cheapest} to ${result[i].Document.expensive}";
    var ratingText = $"Rating: {result[i].Document.Rating}";

    string fullDescription = result[i].Document.Description;

    // Display the hotel details.
    @Html.TextArea($"name{i}", result[i].Document.HotelName, new { @class = "box1A" })
    @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
    @Html.TextArea($"rates{i}", rateText, new { @class = "box2A" })
    @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
}

更改主控制器中的 Next 方法，传递房价供后续结果页面使用。

public async Task<ActionResult> Next(SearchData model)
{
    // Set the next page setting, and call the Index(model) action.
    model.paging = "next";
    await Index(model);

    // Create an empty list.
    var nextHotels = new List<string>();

    // Add a hotel details to the list.
    await foreach (var result in model.resultList.GetResultsAsync())
    {
        var ratingText = $"Rating: {result.Document.Rating}";
        var rateText = $"Rates from ${result.Document.cheapest} to ${result.Document.expensive}";

        string fullDescription = result.Document.Description;

        // Add strings to the list.
        nextHotels.Add(result.Document.HotelName);
        nextHotels.Add(ratingText);
        nextHotels.Add(rateText);
        nextHotels.Add(fullDescription);
    }

    // Rather than return a view, return the list of data.
    return new JsonResult(nextHotels);
}

更新视图中的 scrolled 函数来处理房价文本。

<script>
    function scrolled() {
        if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
            $.getJSON("/Home/Next", function (data) {
                var div = document.getElementById('myDiv');

                // Append the returned data to the current list of hotels.
                for (var i = 0; i < data.length; i += 4) {
                    div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box1B">' + data[i + 1] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box2A">' + data[i + 2] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box3">' + data[i + 4] + '</textarea>';
                }
            });
        }
    }
</script>

运行应用并验证是否已显示房价范围。

搜索参数的 OrderBy 属性将不接受 Rooms.BaseRate 之类的条目来提供最低房价，即使客房已按房价进行排序。在这种情况下，房间不按费率排序。为了显示示例数据集中已按房价排序的酒店，你必须在主控制器中对结果进行排序，并按所需顺序将这些结果发送到视图中。

根据多个值对结果排序

现在的问题是如何区分评级相同的酒店。一种方法是根据酒店最后一次翻新的时间进行二次排序，这样最近翻新过的酒店在结果中的排名会比较高。

若要添加第二级排序，请将 LastRenovationDate 添加到搜索结果以及“索引(SearchData 模型)”方法中的 OrderBy 。
```
options.Select.Add("LastRenovationDate");

options.OrderBy.Add("LastRenovationDate desc");
```
提示

可在 OrderBy 列表中输入任意数量的属性。如果酒店评级和翻新日期都相同，则可输入第三个属性来区分它们。

同样，我们需要在视图中查看翻新日期，从而确定排序正确。对于翻新之类的问题，可能只需查看年份即可。将视图中的呈现循环更改为以下代码。

<!-- Show the hotel data. -->
@for (var i = 0; i < result.Count; i++)
{
    var rateText = $"Rates from ${result[i].Document.cheapest} to ${result[i].Document.expensive}";
    var lastRenovatedText = $"Last renovated: { result[i].Document.LastRenovationDate.Value.Year}";
    var ratingText = $"Rating: {result[i].Document.Rating}";

    string fullDescription = result[i].Document.Description;

    // Display the hotel details.
    @Html.TextArea($"name{i}", result[i].Document.HotelName, new { @class = "box1A" })
    @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
    @Html.TextArea($"rates{i}", rateText, new { @class = "box2A" })
    @Html.TextArea($"renovation{i}", lastRenovatedText, new { @class = "box2B" })
    @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
}

更改主控制器中的 Next 方法，推进上次翻新日期的年份组件。

    public async Task<ActionResult> Next(SearchData model)
    {
        // Set the next page setting, and call the Index(model) action.
        model.paging = "next";
        await Index(model);

        // Create an empty list.
        var nextHotels = new List<string>();

        // Add a hotel details to the list.
        await foreach (var result in model.resultList.GetResultsAsync())
        {
            var ratingText = $"Rating: {result.Document.Rating}";
            var rateText = $"Rates from ${result.Document.cheapest} to ${result.Document.expensive}";
            var lastRenovatedText = $"Last renovated: {result.Document.LastRenovationDate.Value.Year}";

            string fullDescription = result.Document.Description;

            // Add strings to the list.
            nextHotels.Add(result.Document.HotelName);
            nextHotels.Add(ratingText);
            nextHotels.Add(rateText);
            nextHotels.Add(lastRenovatedText);
            nextHotels.Add(fullDescription);
        }

        // Rather than return a view, return the list of data.
        return new JsonResult(nextHotels);
    }

更改视图中的 scrolled 函数来显示翻新文本。

<script>
    function scrolled() {
        if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
            $.getJSON("/Home/Next", function (data) {
                var div = document.getElementById('myDiv');

                // Append the returned data to the current list of hotels.
                for (var i = 0; i < data.length; i += 5) {
                    div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box1B">' + data[i + 1] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box2A">' + data[i + 2] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box2B">' + data[i + 3] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box3">' + data[i + 4] + '</textarea>';
                }
            });
        }
    }
</script>

运行应用。搜索常用词（例如“泳池”或“视野”），并验证评级相同的酒店现在是否按翻新日期降序显示。

根据计分概要文件对结果排序

本教程中截止目前提供的示例展示了如何根据数值（评级和翻新日期）进行排序，并提供了确切的排序顺序。但是，部分搜索和一些数据不会使自身实现两个数据元素之间的此类简单比较。对于全文搜索查询，认知搜索包括排名的概念。可以指定计分概要文件来影响结果的排名方式，从而进行更复杂的定性比较。

计分概要文件在索引架构中进行定义。已针对酒店数据设置了多个计分概要文件。让我们看看如何定义计分概要文件，然后试着编写代码来搜索这些文件。

如何定义计分概要文件

计分概要文件在设计时在搜索索引中进行定义。 Microsoft 托管的只读酒店索引有三个计分概要文件。本部分介绍计分概要文件，并演示如何在代码中使用。

下面是酒店数据集的默认计分概要文件，使用时无需指定任何 OrderBy 或 ScoringProfile 参数。如果酒店名称、说明和标记列表（便利设施）中出现搜索文本，此概要文件可提高酒店的得分。请注意，评分的权重如何偏向某些字段。如果搜索文本出现在未下述所列的另一字段中，则它的权重为 1。很明显，分数越高，结果在视图中显示的排名就越高。
```
{
   "name": "boostByField",
   "text": {
       "weights": {
           "Tags": 3,
           "HotelName": 2,
           "Description": 1.5,
           "Description_fr": 1.5,
       }
   }
}
```

如果提供的参数包含一个或多个标记列表（我们称为“便利设施”），以下可选计分概要文件可大幅提高分数。此概要文件的要点是，必须提供参数且参数带有文本。如果未提供参数或参数为空，则将引发错误。

{
    "name":"boostAmenities",
    "functions":[
        {
        "fieldName":"Tags",
        "freshness":null,
        "interpolation":"linear",
        "magnitude":null,
        "distance":null,
        "tag":{
            "tagsParameter":"amenities"
        },
        "type":"tag",
        "boost":5
        }
    ],
    "functionAggregation":0
},

在第三个概要文件中，酒店评级可大幅提高分数。上次翻新日期也将提高分数，但仅在该数据位于当前日期的 730 天（2 年）范围内才有效。

{
    "name":"renovatedAndHighlyRated",
    "functions":[
        {
        "fieldName":"Rating",
        "freshness":null,
        "interpolation":"linear",
        "magnitude":{
            "boostingRangeStart":0,
            "boostingRangeEnd":5,
            "constantBoostBeyondRange":false
        },
        "distance":null,
        "tag":null,
        "type":"magnitude",
        "boost":20
        },
        {
        "fieldName":"LastRenovationDate",
        "freshness":{
            "boostingDuration":"P730D"
        },
        "interpolation":"quadratic",
        "magnitude":null,
        "distance":null,
        "tag":null,
        "type":"freshness",
        "boost":10
        }
    ],
    "functionAggregation":0
}

接下来，看看这些概要文件是否按我们所预想的发挥作用。

向视图添加代码来比较概要文件

打开 index.cshtml 文件，将 <body> 部分替换为以下代码。

<body>

@using (Html.BeginForm("Index", "Home", FormMethod.Post))
{
    <table>
        <tr>
            <td></td>
            <td>
                <h1 class="sampleTitle">
                    <img src="~/images/azure-logo.png" width="80" />
                    Hotels Search - Order Results
                </h1>
            </td>
        </tr>
        <tr>
            <td></td>
            <td>
                <!-- Display the search text box, with the search icon to the right of it. -->
                <div class="searchBoxForm">
                    @Html.TextBoxFor(m => m.searchText, new { @class = "searchBox" }) <input class="searchBoxSubmit" type="submit" value="">
                </div>

                <div class="searchBoxForm">
                    <b>&nbsp;Order:&nbsp;</b>
                    @Html.RadioButtonFor(m => m.scoring, "Default") Default&nbsp;&nbsp;
                    @Html.RadioButtonFor(m => m.scoring, "RatingRenovation") By numerical Rating&nbsp;&nbsp;
                    @Html.RadioButtonFor(m => m.scoring, "boostAmenities") By Amenities&nbsp;&nbsp;
                    @Html.RadioButtonFor(m => m.scoring, "renovatedAndHighlyRated") By Renovated date/Rating profile&nbsp;&nbsp;
                </div>
            </td>
        </tr>

        <tr>
            <td valign="top">
                <div id="facetplace" class="facetchecks">

                    @if (Model != null && Model.facetText != null)
                    {
                        <h5 class="facetheader">Amenities:</h5>
                        <ul class="facetlist">
                            @for (var c = 0; c < Model.facetText.Length; c++)
                            {
                                <li> @Html.CheckBoxFor(m => m.facetOn[c], new { @id = "check" + c.ToString() }) @Model.facetText[c] </li>
                            }

                        </ul>
                    }
                </div>
            </td>
            <td>
                @if (Model != null && Model.resultList != null)
                {
                    // Show the total result count.
                    <p class="sampleText">
                        @Html.DisplayFor(m => m.resultList.Count) Results <br />
                    </p>

                    <div id="myDiv" style="width: 800px; height: 450px; overflow-y: scroll;" onscroll="scrolled()">

                        <!-- Show the hotel data. -->
                        @for (var i = 0; i < Model.resultList.Results.Count; i++)
                        {
                            var rateText = $"Rates from ${Model.resultList.Results[i].Document.cheapest} to ${Model.resultList.Results[i].Document.expensive}";
                            var lastRenovatedText = $"Last renovated: { Model.resultList.Results[i].Document.LastRenovationDate.Value.Year}";
                            var ratingText = $"Rating: {Model.resultList.Results[i].Document.Rating}";

                            string amenities = string.Join(", ", Model.resultList.Results[i].Document.Tags);
                            string fullDescription = Model.resultList.Results[i].Document.Description;
                            fullDescription += $"\nAmenities: {amenities}";

                            // Display the hotel details.
                            @Html.TextArea($"name{i}", Model.resultList.Results[i].Document.HotelName, new { @class = "box1A" })
                            @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
                            @Html.TextArea($"rates{i}", rateText, new { @class = "box2A" })
                            @Html.TextArea($"renovation{i}", lastRenovatedText, new { @class = "box2B" })
                            @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
                        }
                    </div>

                    <script>
                        function scrolled() {
                            if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
                                $.getJSON("/Home/Next", function (data) {
                                    var div = document.getElementById('myDiv');

                                    // Append the returned data to the current list of hotels.
                                    for (var i = 0; i < data.length; i += 5) {
                                        div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                                        div.innerHTML += '<textarea class="box1B">' + data[i + 1] + '</textarea>';
                                        div.innerHTML += '\n<textarea class="box2A">' + data[i + 2] + '</textarea>';
                                        div.innerHTML += '<textarea class="box2B">' + data[i + 3] + '</textarea>';
                                        div.innerHTML += '\n<textarea class="box3">' + data[i + 4] + '</textarea>';
                                    }
                                });
                            }
                        }
                    </script>
                }
            </td>
        </tr>
    </table>
}
</body>

打开 SearchData.cs 文件，将 SearchData 类替换为以下代码。

public class SearchData
{
    public SearchData()
    {
    }

    // Constructor to initialize the list of facets sent from the controller.
    public SearchData(List<string> facets)
    {
        facetText = new string[facets.Count];

        for (int i = 0; i < facets.Count; i++)
        {
            facetText[i] = facets[i];
        }
    }

    // Array to hold the text for each amenity.
    public string[] facetText { get; set; }

    // Array to hold the setting for each amenitity.
    public bool[] facetOn { get; set; }

    // The text to search for.
    public string searchText { get; set; }

    // Record if the next page is requested.
    public string paging { get; set; }

    // The list of results.
    public DocumentSearchResult<Hotel> resultList;

    public string scoring { get; set; }       
}

打开 hotels.css 文件并添加以下 HTML 类。

.facetlist {
    list-style: none;
}

.facetchecks {
    width: 250px;
    display: normal;
    color: #666;
    margin: 10px;
    padding: 5px;
}

.facetheader {
    font-size: 10pt;
    font-weight: bold;
    color: darkgreen;
}

向控制器添加代码来指定计分概要文件

打开主控制器文件。添加以下 using 语句来帮助创建列表。
```
using System.Linq;
```

在本例中，我们需要首次调用 Index，使其不仅返回初始视图。此方法现最多搜索 20 个要在视图中显示的便利设施。

    public async Task<ActionResult> Index()
    {
        InitSearch();

        // Set up the facets call in the search parameters.
        SearchOptions options = new SearchOptions();
        // Search for up to 20 amenities.
        options.Facets.Add("Tags,count:20");

        SearchResults<Hotel> searchResult = await _searchClient.SearchAsync<Hotel>("*", options);

        // Convert the results to a list that can be displayed in the client.
        List<string> facets = searchResult.Facets["Tags"].Select(x => x.Value.ToString()).ToList();

        // Initiate a model with a list of facets for the first view.
        SearchData model = new SearchData(facets);

        // Save the facet text for the next view.
        SaveFacets(model, false);

        // Render the view including the facets.
        return View(model);
    }

我们需要两个专用方法，以将分面保存到临时存储，同时从临时存储中返回这些分面并填充模型。

    // Save the facet text to temporary storage, optionally saving the state of the check boxes.
    private void SaveFacets(SearchData model, bool saveChecks = false)
    {
        for (int i = 0; i < model.facetText.Length; i++)
        {
            TempData["facet" + i.ToString()] = model.facetText[i];
            if (saveChecks)
            {
                TempData["faceton" + i.ToString()] = model.facetOn[i];
            }
        }
        TempData["facetcount"] = model.facetText.Length;
    }

    // Recover the facet text to a model, optionally recoving the state of the check boxes.
    private void RecoverFacets(SearchData model, bool recoverChecks = false)
    {
        // Create arrays of the appropriate length.
        model.facetText = new string[(int)TempData["facetcount"]];
        if (recoverChecks)
        {
            model.facetOn = new bool[(int)TempData["facetcount"]];
        }

        for (int i = 0; i < (int)TempData["facetcount"]; i++)
        {
            model.facetText[i] = TempData["facet" + i.ToString()].ToString();
            if (recoverChecks)
            {
                model.facetOn[i] = (bool)TempData["faceton" + i.ToString()];
            }
        }
    }

我们需要根据需要设置 OrderBy 和 ScoringProfile 参数。将现有 Index(SearchData model) 方法替换为以下内容。

public async Task<ActionResult> Index(SearchData model)
{
    try
    {
        InitSearch();

        int page;

        if (model.paging != null && model.paging == "next")
        {
            // Recover the facet text, and the facet check box settings.
            RecoverFacets(model, true);

            // Increment the page.
            page = (int)TempData["page"] + 1;

            // Recover the search text.
            model.searchText = TempData["searchfor"].ToString();
        }
        else
        {
            // First search with text. 
            // Recover the facet text, but ignore the check box settings, and use the current model settings.
            RecoverFacets(model, false);

            // First call. Check for valid text input, and valid scoring profile.
            if (model.searchText == null)
            {
                model.searchText = "";
            }
            if (model.scoring == null)
            {
                model.scoring = "Default";
            }
            page = 0;
        }

        // Setup the search parameters.
        var options = new SearchOptions
        {
            SearchMode = SearchMode.All,

            // Skip past results that have already been returned.
            Skip = page * GlobalVariables.ResultsPerPage,

            // Take only the next page worth of results.
            Size = GlobalVariables.ResultsPerPage,

            // Include the total number of results.
            IncludeTotalCount = true,
        };
        // Select the data properties to be returned.
        options.Select.Add("HotelName");
        options.Select.Add("Description");
        options.Select.Add("Tags");
        options.Select.Add("Rooms");
        options.Select.Add("Rating");
        options.Select.Add("LastRenovationDate");

        List<string> parameters = new List<string>();
        // Set the ordering based on the user's radio button selection.
        switch (model.scoring)
        {
            case "RatingRenovation":
                // Set the ordering/scoring parameters.
                options.OrderBy.Add("Rating desc");
                options.OrderBy.Add("LastRenovationDate desc");
                break;

            case "boostAmenities":
                {
                    options.ScoringProfile = model.scoring;

                    // Create a string list of amenities that have been clicked.
                    for (int a = 0; a < model.facetOn.Length; a++)
                    {
                        if (model.facetOn[a])
                        {
                            parameters.Add(model.facetText[a]);
                        }
                    }

                    if (parameters.Count > 0)
                    {
                        options.ScoringParameters.Add($"amenities-{ string.Join(',', parameters)}");
                    }
                    else
                    {
                        // No amenities selected, so set profile back to default.
                        options.ScoringProfile = "";
                    }
                }
                break;

            case "renovatedAndHighlyRated":
                options.ScoringProfile = model.scoring;
                break;

            default:
                break;
        }

        // For efficiency, the search call should be asynchronous, so use SearchAsync rather than Search.
        model.resultList = await _searchClient.SearchAsync<Hotel>(model.searchText, options);

        // Ensure TempData is stored for the next call.
        TempData["page"] = page;
        TempData["searchfor"] = model.searchText;
        TempData["scoring"] = model.scoring;
        SaveFacets(model, true);

        // Calculate the room rate ranges.
        await foreach (var result in model.resultList.GetResultsAsync())
        {
            var cheapest = 0d;
            var expensive = 0d;

            foreach (var room in result.Document.Rooms)
            {
                var rate = room.BaseRate;
                if (rate < cheapest || cheapest == 0)
                {
                    cheapest = (double)rate;
                }
                if (rate > expensive)
                {
                    expensive = (double)rate;
                }
            }

            result.Document.cheapest = cheapest;
            result.Document.expensive = expensive;
        }
    }
    catch
    {
        return View("Error", new ErrorViewModel { RequestId = "1" });
    }

    return View("Index", model);
}

浏览每个 switch 选择项的注释。

如果你已为上一部分（“根据多个属性排序”）添加了代码，则我们不需要对 Next 操作进行任何更改。

运行并测试应用

运行应用。你应会在视图中看到一组完整的便利设施。
对于排序，如果选择“按数值评级”，将提供已在本教程中实现的数值排序，其中要在评级相同的酒店之间决定翻新日期。
接下来，尝试“按便利设施”概要文件。进行各种便利设施选择，并验证配有这些便利设施的酒店在结果列表中的排名是否上升了。
请尝试“按翻新日期/评级概要文件”，查看是否获得所期望的结果。只有近期翻新的酒店的新鲜度会提升。

资源

有关详细信息，请参阅下面的将计分概要文件添加到 Azure 认知搜索索引。

要点

请考虑此项目中的以下要点：

用户希望对搜索结果进行排序且最先排列最相关的结果。
需要实现数据结构化，使排序简单起来。我们未能轻松地最先排列“最低房价”，因为数据未结构化，不添加代码就没法进行排序。
可能有很多排序级别，按更高级别的排序在具有相同值的结果之间进行区分。
自认而然地，一些结果会按升序排序（例如到某个点的距离），一些结果按降序排序（例如房客的评级）。
可在数值比较对数据集不可用或不够智能时定义计分概要文件。通过对每个结果评分，有助于按智能方式进行结果排序和显示。

后续步骤

你已学完本系列的 C# 教程，应该已经找到了有关 Azure 认知搜索 API 的宝贵知识。

有关进一步的参考和教程，请考虑浏览 Microsoft Learn 训练目录或 Azure 认知搜索文档中的其他教程。