GetVar 元素（视图）
上次修改时间： 2015年3月9日
适用范围： SharePoint Foundation 2010
本文内容
属性
子元素
父元素
发生次数
在呈现页面的上下文中返回变量。可以在本地将变量设置为 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>
属性
属性 |
说明 |
|---|---|
AutoHyperlink |
可选属性，类型为 Boolean。如果文本显示为超链接（例如，www.microsoft.com），则为 TRUE，此时将使用 <A> 标记围住文本。 |
AutoHyperLinkNoEncoding |
可选属性，类型为 Boolean。如果文本显示为超链接（例如，www.microsoft.com）但没有进行 HTML 编码，则为 TRUE，此时将使用 <A> 标记围住文本。 |
AutoNewLine |
可选属性，类型为 Boolean。如果为 TRUE，则将 <BR> 标记插入文本流中，并使用无间断空格 ( ) 替代多个空格。 |
Default |
可选属性，类型为 Text。如果由另一个元素的 Select 属性返回的值是空字符串，则呈现分配给此属性的文本。 |
ExpandXML |
可选属性，类型为 Boolean。如果为 TRUE，则通过协作应用程序标记语言 (CAML) 解释器（它允许 CAML 呈现 CAML）重新传递所呈现的内容。 |
HTMLEncode |
可选属性，类型为 Boolean。如果为 TRUE，则转换嵌入的字符，以便这些字符作为文本显示在浏览器中。换句话说，就是将可能与 HTML 标记混淆的字符转换为实体。 |
Name |
必需属性，类型为 Text。变量的名称。 |
Scope |
如果设置为 Request，则该变量在页面上全局可用。 |
StripWS |
可选属性，类型为 Boolean。如果为 TRUE，则从由该元素返回的值的开始和结尾删除空格。 |
URLEncode |
可选属性，类型为 Boolean。如果为 TRUE，则将特殊字符（如空格）转换为引用的 UTF-8 格式，例如，字符 ë 将转换为 %c3%ab。 |
URLEncodeAsUrl |
可选属性，类型为 Boolean。虽然类似于 URLEncode，但若要指定要编码的字符串是 URL 的路径组件以便不对左斜线（"/"）进行编码，则为 TRUE。 |
子元素
无 |
父元素
很多 |
发生次数
最小值：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，则显示"隐藏筛选选项"。否则，默认操作将实现第二条 Switch 语句来计算第二个变量 FilterField1。如果 FilterField1 的值为空字符串，则不应用任何筛选器，工具栏中将显示"筛选器"；否则，默认操作将显示"更改筛选器"。