Элемент GetVar (View)

Применимо к: 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> тегов в текстовый поток и замены нескольких пробелов неразрывным пробелом (&nbsp;).
По умолчанию
Необязательный текст. Визуализирует текст, назначенный этому атрибуту, если атрибут 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 является пустой строкой, фильтр не применяется и фильтр отображается на панели инструментов; В противном случае действие по умолчанию — отображение фильтра изменений.

См. также

  • Last updated on