Элемент FieldSwitch (View)

Статья
04/08/2023

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Устаревшие. Условное отображение на основании значения свойства поля.

<FieldSwitch
   StripWS = "TRUE" | "FALSE">
       <Expr></Expr>
       <Case Value="Value_1"></Case>
       <Case Value="Value_2"></Case>
       ...
       <Default></Default>
</FieldSwitch>

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
StripwS	Необязательный логический. TRUE используется для удаления пробелов в начале и в конце возвращаемого элементом значения.

Дочерние элементы

Родительские элементы

Многочисленные

Occurrences

Минимум: 0
Максимум: без ограничений

Замечания

Элементы FieldSwitch и Switch используют одинаковый синтаксис, но элемент FieldSwitch оценивается только один раз в течение запроса для каждого представления, в котором он используется для просмотра тела, или для каждого поля, в котором он применяется для отображения шаблона. Элемент FieldSwitch существенно оптимизирует производительность в случаях, когда требуются различные пути кода CAML, зависящие от свойств поля (например, если разрешено расширенное тестовое форматирование), значение которого не изменяется во процессе отображения страницы.

Элемент FieldSwitch содержит элемент Expr, любое количество элементов Case и элемент Default. Значение элемента Expr сравнивается с атрибутом Value каждого элемента Case. При обнаружении совпадения элемент FieldSwitch возвращает значение подходящего элемента Case. Если совпадение не найдено и если задан элемент Default , элемент FieldSwitch возвращает значение элемента Default . Если элемент Default не указан и ни одно из значений Case не соответствует значению Expr , элемент FieldSwitch возвращает пустую строку.

Этот элемент не требует наличия определенного родительского элемента.

Пример

В следующем примере из файла FldTypes.xml определяются два разных шаблона отрисовки для поля Заметки в зависимости от того, имеет ли поле форматированный текст.

<RenderPattern Name="DisplayPattern" DisplayName="DisplayPattern">
   <FieldSwitch>
      <Expr>
         <Property Select="RichText" />
      </Expr>
      <Case Value="TRUE">
         <Column AutoHyperLinkNoEncoding="TRUE" />
      </Case>
      <Default>
         <Column HTMLEncode="TRUE" AutoHyperLink="TRUE"
            AutoNewLine="TRUE" />
      </Default>
   </FieldSwitch>
</RenderPattern>

См. также

Элемент Switch (View)

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