SetVar 元素（视图）
上次修改时间： 2015年3月9日
适用范围： SharePoint Foundation 2010
本文内容
属性
子元素
父元素
出现次数
允许在本地将页呈现到当前 XML 级别或将页全局呈现到页的上下文中设置变量。
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
属性
属性 |
说明 |
|---|---|
ID |
可选属性，类型为 Text。提供变量的 ID。 |
Name |
必需属性，类型为 Text。指定变量的名称。 |
Scope |
如果设置为 Request，则变量是全局变量。 |
Value |
可选属性，类型为 Text。当这是一个空元素时，可用于为变量指定值。 |
子元素
无 |
父元素
很多 |
出现次数
最小值：0 最大值：无限制 |
备注
SetVar 元素具有跨越和非跨越格式，以便 <SetVar Name="MyVar">Announcements</SetVar> 与 <SetVar Name="MyVar" Value="Announcements/> 相同。
如果在 SetVar 元素中指定 Scope="Request"，则变量赋值会在当前页中的任何地方生效。否则，赋值仅影响 SetVar 元素的子级。
SetVar 元素通常为用于请求批处理的 Method 元素的子级。
SetVar 元素常用于通过将 DisplayMode 设置为下列值之一来更改显示模式。
值 |
说明 |
|---|---|
DISPLAY |
呈现视图的 ViewBody 部分时使用。 |
EDIT |
呈现编辑项目表单时使用。 |
DISPLAYHEAD |
呈现视图的 ViewHeader 部分时使用。 |
NEW |
呈现新项目表单时使用。 |
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_2"的 SetVar 元素仅适用于"Sample"元素的子级。"Value_2"在"Sample"结束标记之后超出范围。
<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>