用于在 SharePoint Server 中显示经典搜索结果的结果类型和显示模板
适用于：
2013 2016 2019 Subscription Edition 
SharePoint in Microsoft 365
SharePoint Server 包括许多默认搜索功能，这些功能在帮助用户找到所需内容方面非常出色。 但是，您可能希望让搜索结果以某种方式显示，例如，显示特定于您的公司或企业的信息。 若要自定义搜索结果的显示方式及其包含的信息，您可以创建新的结果类型和显示模板，或更改现有的结果类型和显示模板。 本文不介绍如何做到这一点，但概述了用于显示搜索结果的默认结果类型和显示模板。
关于结果类型
当您在 SharePoint 网站上进行搜索时，往往会返回许多搜索结果。 默认情况下，这些搜索结果会以不同方式显示，便于您轻松区分不同的搜索结果类型。 例如，只需看看下面的图片，您就可以看到前两个搜索结果是 PowerPoint 演示文稿，而第三个结果是 Word 文档等。
若要像这样以不同方式显示搜索结果，就要将搜索结果分为不用的 结果类型。 结果类型是搜索结果的分类。 例如，如果发现一个搜索结果是 Microsoft PowerPoint 演示文稿格式，则该搜索结果属于 Microsoft PowerPoint 结果类型。 如果发现一个搜索结果是 PDF 文件格式，则该搜索结果属于 PDF 结果类型。
下表显示了默认的结果类型。
| 结果类型 | 搜索结果位于以下项中 |
|---|---|
| Person |
本地人员结果结果源 |
| Microsoft Access |
Microsoft Access 文件 |
| Microsoft Excel |
Microsoft Excel 文件 |
| Microsoft OneNote |
Microsoft OneNote 文件 |
| Microsoft PowerPoint |
Microsoft PowerPoint 文件 |
| Microsoft Publisher |
Microsoft Publisher 文件 |
| Microsoft Visio |
Microsoft Visio 文件 |
| Microsoft Word |
Microsoft Word 文件 |
| 讨论 |
社区网站中的条目 |
| 回复 |
对电子邮件的回复 |
| 电子邮件 |
电子邮件 |
| 图像 |
图像文件 |
| PDF |
PDF 文件 |
| 文本 |
TXT 文件 |
| 视频 |
视频文件 |
| XML |
XML 文件 |
| Zip |
ZIP 文件 |
| SharePoint 博客 |
SharePoint 博客网站 |
| SharePoint 社区 |
SharePoint 社区网站 |
| SharePoint 讨论板 |
SharePoint 讨论板库 |
| SharePoint 文档库 |
SharePoint 文档库 |
| SharePoint 列表 |
SharePoint 列表 |
| SharePoint 微博帖子 |
SharePoint 博客网站中的博客文章 |
| SharePoint 图片库 |
SharePoint 图片库 |
| SharePoint 网站 |
SharePoint 网站 |
| SharePoint 调查 |
SharePoint 调查 |
| SharePoint Wiki |
SharePoint Enterprise Wiki 网站 |
| SharePoint 图片库列表项 |
SharePoint 图片库中的项目 |
| SharePoint 列表项 |
SharePoint 列表中的项目 |
| 网页 |
外部网页，如 HTML 或 ASPX 页面 |
| 默认结果类型 |
其他结果类型所不包含的任何类型，如 Java 文件、C++ 或 C# |
如何连接结果类型和显示模板
在 SharePoint 搜索中心，搜索结果显示在“搜索结果 Web 部件”中。 若要控制搜索结果的显示方式，可以使用两种类型的显示模板：
项目显示模板
悬停面板显示模板
项目显示模板定义每个结果的显示方式。 悬停面板显示模板在用户将鼠标指针悬停在搜索结果上时显示其他信息。
下图显示如何连接结果类型和显示模板。
每个结果类型是指一个项目显示模板。
每个项目显示模板包含一个引用悬停面板显示模板的变量。 此变量为
var hoverUrl。
下表显示了如何将默认结果类型连接到项目显示模板和悬停面板显示模板。
| 结果类型 | 用户界面中显示的项目显示模板标题 | 母版页样式库中显示的项目显示模板文件名称 | 母版页样式库中显示的悬停面板显示模板文件名称 |
|---|---|---|---|
| Person |
人员项 |
Item_Person |
Item_Person_HoverPanel |
| Microsoft Access |
Office 文档项 |
Item_OfficeDocument |
Item_OfficeDocument_HoverPanel |
| Microsoft Excel |
Excel 项目 |
Item_Excel |
Item_Excel_HoverPanel |
| Microsoft OneNote |
OneNote 项目 |
Item_OneNote |
Item_OneNote_HoverPanel |
| Microsoft Powerpoint |
PowerPoint 项 |
Item_PowerPoint |
Item_PowerPoint_HoverPanel |
| Microsoft Publisher |
Office 文档项 |
Item_OfficeDocument |
Item_OfficeDocument_HoverPanel |
| Microsoft Visio |
Office 文档项 |
Item_OfficeDocument |
Item_OfficeDocument_HoverPanel |
| Microsoft Word |
Word 项 |
Item_Word |
Item_Word_HoverPanel |
| 讨论 |
讨论 |
Item_Discussion |
Item_Discussion_HoverPanel |
| 回复 |
回复项 |
Item_Reply |
Item_Reply_HoverPanel |
| Email |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| 图像 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| PDF |
PDF 项 |
Item_PDF |
Item_PDF_HoverPanel |
| 文本 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| 视频 |
视频项 |
Item_Video |
Item_Video_HoverPanel |
| XML |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| Zip |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 博客 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 社区 |
社区项 |
Item_Community |
Item_Community_HoverPanel |
| SharePoint 讨论板 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 文档库 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 列表 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 微博帖子 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 图片库 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 网站 |
网站项 |
Item_Site |
Item_Site_HoverPanel |
| SharePoint 调查 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint Wiki |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| SharePoint 图片库列表项 |
图片项 |
Item_Picture |
Item_Picture_HoverPanel |
| SharePoint 列表项 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
| 网页 |
网页项目 |
Item_WebPage |
Item_WebPage_HoverPanel |
| 默认结果类型 |
默认项 |
Item_Default |
Item_Default_HoverPanel |
所有结果类型使用的常用显示模板
除前一节中列出的显示模板外，还有一些所有结果类型都可使用的显示模板。 这些被称为常用显示模板。 常用显示模板可由项目显示模板和悬停面板显示模板引用。 下图显示它们的引用方式。
每个项目显示模板引用常用项目主体项显示模板。 引用为
_#=ctx.RenderBody(ctx)=#_。每个悬停面板显示模板包含对三个常用悬停面板显示模板的三个引用。 引用为
_#=ctx.RenderHeader(ctx)=#_,_#=ctx.RenderBody(ctx)=#_和_#=ctx.RenderFooter(ctx)=#_。
下表显示了常用显示模板。
| 用户界面中显示的显示模板标题 | 母版页样式库中显示的显示模板名称 | 说明 |
|---|---|---|
| 常用项目主体 |
Item_CommonItem_Body |
显示搜索结果 Web 部件的主体中的信息。 |
| 常用悬停面板标题 |
Item_CommonHoverPanel |
显示悬停面板的标题中的信息。 |
| 常用悬停面板 |
Item_CommonPanel_Body |
显示悬停面板的主体中的信息。 |
| 常用悬停面板的操作 |
Item_CommonHoverPanel_Actions |
显示悬停面板页脚中的操作，如“编辑”或“发送”。 |
用于已升级结果的显示模板
您可以使用查询规则来升级单个结果，让它们出现在搜索结果列表的顶部。 已升级的结果通过使用尚未连接到结果类型的特定项目显示模板来显示。 因此，它可用来显示所有已升级的搜索结果。 此显示模板不会引用悬停面板显示模板。
下表显示了用于已升级结果的显示模板。
| 项目显示模板标题 | 母版页样式库中显示的项目显示模板文件名称 | 说明 |
|---|---|---|
| 最佳匹配项 |
Item_BestBet |
显示通过使用查询规则升级的搜索结果。 |