SetVar 元素 (视图)
适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
允许在本地将页呈现到当前 XML 级别或将页全局呈现到页的上下文中设置变量。
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
元素和属性
下面各部分介绍了属性、子元素和父元素。
Attributes
| 属性 | 说明 |
|---|---|
| ID |
可选属性，类型为 Text。 提供变量的 ID。 |
| 名称 |
必需属性，类型为 Text。 指定变量的名称。 |
| Scope |
如果设置为 Request，则变量是全局变量。 |
| 值 |
可选属性，类型为 Text。 当这是一个空元素时，可用于为变量指定值。 |
子元素
无
父元素
众多
出现次数
- 最小值：0
- 最大值：无限制
备注
SetVar 元素具有跨越和非跨越形式，因此与 <SetVar Name="MyVar">Announcements</SetVar> 相同<SetVar Name="MyVar" Value="Announcements/>。
如果在 SetVar 元素中指定 Scope="Request"，则变量赋值会在当前页中的任何地方生效。 否则，赋值仅影响 SetVar 元素的子级。
SetVar 元素通常为用于请求批处理的 Method 元素的子级。
SetVar 元素常用于通过将 DisplayMode 设置为下列值之一来更改显示模式。
| 值 | 说明 |
|---|---|
| 显示 |
呈现视图的 ViewBody 部分时使用。 |
| 编辑 |
呈现编辑项目表单时使用。 |
| DISPLAYHEAD |
呈现视图的 ViewHeader 部分时使用。 |
| 新增功能 |
呈现新项目表单时使用。 |
| PREVIEWDISPLAY |
使用 Microsoft FrontPage 编辑显示表单时使用。 |
| PREVIEWNEW |
使用 FrontPage 编辑新项目表单时使用。 |
| PREVIEWEDIT |
使用 FrontPage 编辑某个编辑项目表单时使用。 |
示例
下面的示例演示如何使用 SetVar 元素来设置变量的全局范围。 第二行返回在第一行中设置的值。
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
在以下示例中，第一个 GetVar 元素返回Value_2，第二个 GetVar 元素返回Value_1，因为包含 的 Value_2SetVar 元素仅适用于 Sample 元素的子元素。 Value_2 结束示例标记后超出范围。
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
以下示例评估是否需要字段，如果需要，将创建“新建”或“编辑”窗体中所需字段旁边的红色星号 (*) ，并将 HasRequired 变量设置为 TRUE。
<Switch>
<Expr>
<Property Select="Required"/>
</Expr>
<Case Value="TRUE">
<HTML><![CDATA[<font color=red> *</font>]]></HTML>
<SetVar Scope="Request" Name="HasRequired">TRUE</SetVar>
</Case>
</Switch>