Элемент SetVar (View)

Статья
04/21/2015

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения

Позволяет установить контекст видимости переменной на странице — локально на текущем уровне XML или глобально на странице.

<SetVar
  ID = "Text"
  Name = "Text"
  Scope = "Request"
  Value = "Text">
</SetVar>

Атрибуты

Атрибут	Описание
ID	Необязательный атрибут типа Text. Идентификатор переменной.
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", потому что элемент 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>

См. также

Ссылка

Элемент GetVar (View)

Поделиться через