Элемент GetVar (View)

Статья
04/08/2023

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

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

<GetVar
  AutoHyperlink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
  Default = "TRUE" | "FALSE"
  ExpandXML = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  Name = "Text"
  Scope ="Request"
    StripWS = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>

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

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

Атрибуты

Атрибут	Описание
AutoHyperlink	Необязательный логический. ЗНАЧЕНИЕ TRUE для заключит текст тегами `<A>` , если текст отображается как гиперссылка, например `www.microsoft.com`.
AutoHyperLinkNoEncoding	Необязательный логический. ЗНАЧЕНИЕ TRUE , если текст `<A>` выглядит как гиперссылка (например, `www.microsoft.com`), но без кодировки HTML.
AutoNewLine	Необязательный логический. Значение TRUE для вставки `<BR>` тегов в текстовый поток и замены нескольких пробелов неразрывным пробелом (` `).
По умолчанию	Необязательный текст. Визуализирует текст, назначенный этому атрибуту, если атрибут Select другого элемента возвращает в качестве значения пустую строку.
ExpandXML	Необязательный логический. TRUE — повторная передача подготовленного к просмотру контента через интерпретатор CAML, что позволяет CAML обрабатывать CAML.
Htmlencode	Необязательный логический. TRUE, чтобы выполнить преобразование внедренных символов для отображения их в браузере в виде текста. Другими словами, символы, похожие на HTML-теги, преобразуются в сущности.
Имя	Обязательный атрибут типа Text. Имя переменной.
Scope	Если установлено значение Request, эта переменная доступна на странице глобально.
StripwS	Необязательный логический. TRUE используется для удаления пробелов в начале и в конце возвращаемого элементом значения.
URLEncode	Необязательный логический. ЗНАЧЕНИЕ TRUE для преобразования специальных символов, таких как пробелы, в формат UTF-8 с кавычками, `%c3%ab` например для символа `ë`.
URLEncodeAsUrl	Необязательный логический. Как URLEncode, но значение TRUE указывает, что кодируемая строка является компонентом пути URL-адреса, чтобы не кодировать косую черту (`/`).

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

Нет

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

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

Occurrences

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

Замечания

Элемент GetVar часто используется внутри элемента Expr в элементе Switch или в элементе IfEqual.

Если переменная Scope="Request" определена в элементе SetVar, назначение значения этой переменной вступит в силу где-нибудь на текущей странице. В противном случае присвоение значения действительно только для дочерних по отношению к SetVar элементов.

Пример

В следующем примере используется элемент GetVar для возврата информации о текущей фильтрации для определения, какой текст надо отобразить в панели инструментов нал списком.

<Switch>
   <Expr>
      <GetVar Name="Filter" />
   </Expr>
   <Case Value="1">
      <HTML>Hide Filter Choices</HTML>
   </Case>
   <Default>
      <Switch>
         <Expr>
            <GetVar Name="FilterField1" />
         </Expr>
         <Case Value="">
            <HTML>Filter</HTML>
         </Case>
         <Default>
            <HTML>Change Filter</HTML>
         </Default>
      </Switch>
   </Default>
</Switch>

Если в списке открыты параметры фильтра, а переменная Filter содержит значение 1, отображается скрытие вариантов фильтра . В противном случае действие по умолчанию реализует вторую инструкцию Switch , которая вычисляет вторую переменную FilterField1. Если значение FilterField1 является пустой строкой, фильтр не применяется и фильтр отображается на панели инструментов; В противном случае действие по умолчанию — отображение фильтра изменений.

См. также

Элемент SetVar (View)

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