SharePoint Server 中的查询变量
适用于：
2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
注意：本文不适用于新式 Microsoft 搜索体验和 API。 若要了解新式搜索，请参阅 配置文件查询变量。
查询变量
下表显示了 Microsoft 365 中 SharePoint Server 和 SharePoint 的查询变量，以及有关如何使用这些变量的示例。
网站和网站集属性
| 查询变量 | 定义 |
|---|---|
| {Site} 或 {Site.URL} |
发出查询的网站的 URL。 例如，此值可用于查询托管属性 Path 的内容。 |
| {Site.ID} |
发出查询的网站的 GUID。 此值对应于托管属性 WebId 的值。 |
| {Site.LCID} |
区域设置的数值，由发出查询的网站上的网站设置中的区域设置指定。 |
| {Site.Locale} |
发出查询的网站的语言，格式为 ll-cc（例如，en-us）。 |
| {站点。<property>} |
发出查询的网站 (SPWeb) 的属性包中的任何属性，包括自定义属性。 |
| {SiteCollection} 或 {SiteCollection.URL} |
发出查询的网站集的 URL。 例如，此值可用于查询托管属性 Path 的内容。 |
| {SiteCollection.ID} |
发出查询的网站集的 GUID。 此值对应于托管属性 SiteID 的值。 |
| {SiteCollection.LCID} |
区域设置的数值，由发出查询的网站集上的网站设置中的区域设置指定。 |
| {SiteCollection.Locale} |
发出查询的网站集的语言，格式为 ll-cc（例如，en-us）。 |
| {SiteCollection。<property>} |
发出查询的网站集 (SPSite) 的根网站 (SPWeb) 的属性包中的任何属性，包括自定义属性。 |
页面、URL 标记、查询字符串和请求属性
| 查询变量 | 定义 |
|---|---|
| {Page} 或 {Page.URL} |
发出查询的页的 URL。 例如，此值可用于查询托管属性 Path 的内容。 |
| {Page.UsageAnalyticsId} |
需要进行使用率分析的项 ID |
| {Page。<FieldName>} |
发出查询的页上的字段的值。 例如，如果发出查询的页包含名为"ContentOwner"的网站栏，则指定 {Page.ContentOwner} 将允许您查询"ContentOwner"的值。 |
| {URLToken。<integer>} |
页面的 URL 中的值。 整数表示值在 URL 中的位置（从右往左计数）。 例如，对于页面 http://www.contoso/audio/mp3/1010101，查询变量 {URLToken.1} 将查询 URL 中的最后一个值 1010101。 查询变量 {URLToken.3} 将查询 URL 中的倒数第三个属性 audio。 您最多可查询到 URL 中的倒数第 9 个位置。 |
| {QueryString。<ParameterName>} |
当前页的 URL 中查询字符串的值。 例如，如果当前页的 URL 包含一个查询字符串（如 ItemNumber=567），则可通过指定 {QueryString.ItemNumber} 获得值 567。 |
| {请求。<PropertyName>} |
当前 http 请求中的值（例如，{Request.Url}）。 |
用户属性
| 查询变量 | 定义 |
|---|---|
| {User} 或 {User.Name} |
发出查询的用户的显示名称。 例如，此值可用于查询托管属性 Author 的内容。 |
| {用户。Email} |
发出查询的用户的电子邮件地址。 例如，此值可用于查询托管属性 WorkEmail 的内容。 |
| {User.SID} |
发出查询的用户的 SID。 |
| {User.LCID} |
发出查询的用户的配置文件中定义的区域设置的数值。 |
| {User.PreferredContentLanguage} |
发出查询的用户的配置文件中的首选内容语言指定的语言。 |
| {User.PreferredDisplayLanguage} |
发出查询的用户的配置文件中的首选显示语言指定的语言。 |
| {用户。<property>} |
发出查询的用户的配置文件中的任何属性（例如，SPS-Interests），包括自定义属性。 |
| {User.Audiences} 仅 (SharePoint) |
与托管属性 ModernAudienceAadObjectIds上的新式 SharePoint 受众目标筛选一起使用。 示例：ModernAudienceAadObjectIds:{User.Audiences}。 |
术语和术语集属性
| 查询变量 | 定义 |
|---|---|
| {Term} 或 {Term.ID} 或 {Term.IDNoChildren} |
前缀为 #0 的当前网站导航节点的 GUID（例如，#083e99dcb-7907-4dc9-abc8-b5614a284f1c）。 例如，此值可用于查询产品目录网站集中的托管属性 owstaxIdMetadataAllTagsInfo 或 owstaxIdProductCatalogItemCategory 的内容。 |
| {Term.IDWithChildren} |
前缀为 # 的当前网站导航节点的 GUID（例如，#83e99dcb-7907-4dc9-abc8-b5614a284f1c）。 这将返回所有使用当前网站导航术语或当前网站导航术语的子级进行标记的项。 例如，此值可用于查询产品目录网站集中的托管属性 owstaxIdProductCatalogItemCategory 的内容。 此值不能用于查询托管属性 owstaxidmetadataalltagsinfo 的内容。 |
| {Term.Name} |
网站导航节点的标签（例如，Audio）。 |
| {Term。<property>} |
术语的属性包中的任何属性，包括自定义属性。 |
| {TermSet} 或 {TermSet.ID} |
用于当前网站导航的术语集的 GUID。 |
| {TermSet.Name} |
用于当前网站导航的术语集的标签。 |
列表和列表项属性
| 查询变量 | 定义 |
|---|---|
| {List} |
当前列表的 URL。 |
| {List。<property>} |
当前列表的任何属性。 |
| {ListItem} |
当前列表项的 URL。 |
| {ListItem。<property>} |
当前列表项的任何属性。 |
其他属性
| 查询变量 | 定义 |
|---|---|
| {Today+/- <天数的整数值>} |
通过在发出查询的日期基础上加/减指定天数计算得出的日期。 日期格式为 YYYY-MM-DD。 例如，此值可用于查询托管属性 LastModifiedTime 的内容。 |
| {SearchBoxQuery} |
在页面的搜索框中输入的查询值。 |
| {CurrentDisplayLanguage} |
基于 MUI 的格式为 ll-cc 的当前显示语言。 |
| {CurrentDisplayLCID} |
基于 MUI 的格式为 ll-cc 的当前显示语言的数值。 |
处理值中的空格
搜索查询使用空格字符标记化用户发出的查询值。 当查询变量扩展为包含空格的值时，完整的值将包含在双引号内。 例如，对于查询 author:{User}，扩展的值将变为 author:"John Smith"。
如果您不希望用双引号包含值（例如，连接多个值时），可在查询变量中使用转义字符。 例如：customProperty:"{\User.Name};{\User.ZipCode}" 将变为 customProperty:"John Smith;98109"。
具有多个值的查询变量
一些查询变量可能返回多个值。 对于返回多个值的查询变量，必须使用以下语法：{|ManagedProperty:{QueryVariable}}。 将使用位 OR 运算组合所有查询变量值。 例如，假定您有一个用于用户的已分类兴趣的术语集。 将使用 User Profile Service 应用程序中的多值属性 SPS-Interests 将所有用户配置为具有一个或多个兴趣。 若要发出对当前用户的任何兴趣的查询，可使用以下语法：{|owstaxIdMetadataAllTagsInfo:{User.SPS-Interests}}。 如果当前用户配置为具有两个兴趣 - 足球 (#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) 和篮球 (#0c2cff933-9377-4692-aa98-ce59768aa38b) - 查询将被转换 到 (owstaxIdMetadataAllTagsInfo：#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) OR (owstaxIdMetadataAllTagsInfo：#0c2cff933-9377-4692-aa98-ce59768aa38b) 。
使用多个值存在一些限制。 多个值仅支持 OR 运算符 ({|) 。 不支持 AND 运算符。 此外，只有类型为“托管元数据”的列才能正确处理多个值事例。 可能使用多个值的其他类型的列，例如类型为 Person、Group 或 Choice 的列，项目将展开为带分隔符的字符串。