通过

GetVar 元素 (视图)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

在呈现页面的上下文中返回变量。 可以在本地将变量设置为 XML 的当前级别，也可以在全局将变量设置为此页面。

<GetVar
  AutoHyperlink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
  Default = "TRUE" | "FALSE"
  ExpandXML = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  Name = "Text"
  Scope ="Request"
    StripWS = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
AutoHyperlink
可选属性，类型为 Boolean。 如果 文本 <A> 显示为超链接，则为 TRUE 以标记将文本括起来， www.microsoft.com例如 。
AutoHyperLinkNoEncoding
可选属性，类型为 Boolean。 如果文本显示为超链接 (（例如 www.microsoft.com ，) 但没有 HTML 编码），则为 TRUE，将文本与<A>标记括起来。
AutoNewLine
可选属性，类型为 Boolean。 如果为 TRUE ，则在文本流中插入 <BR> 标记，并将多个空格替换为非中断空格 (&nbsp;) 。
默认
可选 文本。 如果由其他元素的 Select 属性返回的值为空字符串，则呈现分配给此属性的文本。
ExpandXML
可选属性，类型为 Boolean。 如果为 TRUE，则通过协作应用程序标记语言 (CAML)（允许 CAML 呈现 CAML）解释器重新传递呈现的内容。
HTMLEncode
可选属性，类型为 Boolean。 如果为 TRUE，则转换嵌入的字符，以便这些字符作为文本显示在浏览器中。 换句话说，就是将可能与 HTML 标记混淆的字符转换为实体。
名称
必需属性，类型为 Text。 变量的名称。
Scope
如果设置为 Request，则该变量在页面上全局可用。
StripWS
可选属性，类型为 Boolean。 如果为 TRUE，则移除元素返回的值开头和末尾的空格。
URLEncode
可选属性，类型为 Boolean。 如果为 TRUE ，可将特殊字符（如空格）转换为带引号的 UTF-8 格式，例如字符 %c3%abë。
URLEncodeAsUrl
可选属性，类型为 Boolean。 与 URLEncode 类似，但 为 TRUE ，指定要编码的字符串是 URL 的路径组件，以便不编码 (/) 的正斜杠。

子元素

无

父元素

众多

出现次数

  • 最小值：0
  • 最大值：无限制

备注

GetVar 元素通常用在 Switch 或 IfEqual 元素中的 Expr 元素内。

如果在 SetVar 元素中指定 Scope="Request"，则变量分配将在当前页面上的任何位置生效。 否则，赋值仅影响 SetVar 元素的子级。

示例

下面的示例使用 GetVar 元素来返回当前筛选信息，以确定要在列表上方的工具栏中显示的文本。

<Switch>
   <Expr>
      <GetVar Name="Filter" />
   </Expr>
   <Case Value="1">
      <HTML>Hide Filter Choices</HTML>
   </Case>
   <Default>
      <Switch>
         <Expr>
            <GetVar Name="FilterField1" />
         </Expr>
         <Case Value="">
            <HTML>Filter</HTML>
         </Case>
         <Default>
            <HTML>Change Filter</HTML>
         </Default>
      </Switch>
   </Default>
</Switch>

如果列表上打开了筛选器选项，并且 Filter 变量包含 1 个，则显示 “隐藏筛选器选项 ”。 否则，默认操作将实现计算第二个变量 FilterField1 的第二个 Switch 语句。 如果 FilterField1 的值为空字符串，则不应用任何筛选器，并且工具栏中显示 Filter ;否则，默认操作是显示 更改筛选器。

另请参阅