Элемент SetVar (View)
Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Позволяет установить контекст видимости переменной на странице — локально на текущем уровне XML или глобально на странице.
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
Элементы и атрибуты
В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
| Атрибут | Описание |
|---|---|
| ID |
Необязательный атрибут типа Text. Идентификатор переменной. |
| Имя |
Обязательный атрибут типа Text. Имя переменной. |
| Scope |
Если установлен в Request, переменная будет глобальной. |
| Value (Значение) |
Необязательный атрибут типа Text. Может использоваться для задания переменной значения. |
Дочерние элементы
Нет
Родительские элементы
Многочисленные
Occurrences
- Минимум: 0
- Максимум: без ограничений
Замечания
Элемент SetVar имеет как формат spanning, так и не охватывающий, поэтому <SetVar Name="MyVar">Announcements</SetVar> он будет таким же, как <SetVar Name="MyVar" Value="Announcements/>.
Если в элементе SetVar указано Scope="Request", присвоение переменной значения будет действительно в любом месте текущей страницы. В противном случае присвоение значения действительно только для дочерних по отношению к SetVar элементов.
Элемент SetVar часто выступает дочерним элементом по отношению к элементу Method, который используется в пакетной обработке запросов.
Также элемент SetVar часто используется для изменения режима отображения путем установки переменной DisplayMode в одно из следующих значений.
| Значение | Описание |
|---|---|
| ОТОБРАЖЕНИЯ |
Используется при отображении раздела ViewBody представления. |
| РЕДАКТИРОВАТЬ |
Используется при отображении формы редактирования элемента. |
| DISPLAYHEAD |
Используется при отображении раздела ViewHeader представления. |
| Новые функции |
Используется при отображении формы создания элемента. |
| PREVIEWDISPLAY |
Используется при редактировании средствами Microsoft FrontPage формы отображения элемента. |
| ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯНОВОЕ |
Используется при редактировании средствами FrontPage формы создания элемента. |
| PREVIEWEDIT |
Используется при редактировании средствами FrontPage формы редактирования элемента. |
Примеры
В следующем примере иллюстрируется использование элемента SetVar для установки глобальной области видимости переменной. Вторая строка возвращает значение, установленное на первой строке.
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
В следующем примере возвращается Value_2 первый элемент GetVar, а второй — элемент Value_1GetVar, так как элемент SetVar, содержащийValue_2, применяется только к дочерним элементам элемента 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>