Элемент GetVar (View)

Статья
04/21/2015

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

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

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

Возвращает переменную в контексте отрисовки страницы. Переменные могут быть установлены либо локально для текущего уровня 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	Необязательный атрибут типа Boolean. Значение TRUE говорит о том, что текст должен быть заключен между тегами <A>, если он появляется как гиперссылка, например, www.microsoft.com.
AutoHyperLinkNoEncoding	Необязательный атрибут типа Boolean. Значение TRUE говорит о том, что текст должен быть заключен между тегами <A>, если он появляется как гиперссылка (например, www.microsoft.com) но без HTML-кода.
AutoNewLine	Необязательный атрибут типа Boolean. Значение TRUE говорит о том, что надо вставить теги <BR> в поток текста и заменить многочисленные пробелы на неразрывный пробел ( ).
Default	Необязательный атрибут типа Text. Отрисовывает текст, назначенный этому атрибуту, если значение, возвращаемое атрибутом Select другого элемента, является пустой строкой.
ExpandXML	Необязательный атрибут типа Boolean. Значение TRUE обеспечивает повторную передачу визуализированного контента в интерпретатор языка CAML, позволяя интерпретатору языка CAML визуализировать элементы языка CAML.
HTMLEncode	Необязательный атрибут типа Boolean. Значение TRUE говорит о том, что надо преобразовывать встроенные символы таким образом, чтобы они отображались в браузере как текст. Другими словами, символы, которые могут быть перепутаны с HTML-тегами, преобразуются в сущности.
Name	Обязательный атрибут типа Text. Имя переменной.
Scope	Если установлено значение Request, эта переменная доступна на странице глобально.
StripWS	Необязательный атрибут типа Boolean. Значение TRUE говорит о том, что надо убрать пробелы перед и после значения, возвращаемого элементом.
URLEncode	Необязательный атрибут типа Boolean. Значение TRUE говорит о том, что надо преобразовывать специальные символы, такие как пробелы, в формат UTF-8 в кавычках, например, %c3%ab для символа ë.
URLEncodeAsUrl	Необязательный атрибут типа Boolean. Аналогично URLEncode, но значение TRUE говорит о том, что надо рассматривать кодируемую строку как компонент пути URL-адреса, поэтому символ "левая косая черта" ("/") не кодируется.

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

Не используется

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

Много

Вхождения

Минимум: 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)

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