Элемент LookupColumn (View)

Статья
04/08/2023

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

Выполняет практически те же функции, что и элемент Column, но применим только при обращении к полю Lookup. Единственное различие между элементами Column и LookupColumn для полей Lookup состоит в том, что элемент LookupColumn получает неисправленное значение столбца из внешнего списка, а элемент Column — из локального списка.

<LookupColumn
    HTMLEncode = "TRUE" | "FALSE"    IncludeVersions = "TRUE" | "FALSE"
    Name = "Text"
    ShowField = "Text"
    StripWS = "TRUE" | "FALSE"
    URLEncode = "TRUE" | "FALSE"
    URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>

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

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

Атрибуты

Атрибут	Описание
Htmlencode	Необязательный логический. TRUE, чтобы выполнить преобразование внедренных символов для отображения их в браузере в виде текста. Другими словами, символы, похожие на HTML-теги, преобразуются в сущности.
IncludeVersions	Необязательный логический.
Имя	Обязательный атрибут типа Text. В этом поле указано имя столбца подстановки. Позволяет использовать элемент LookupColumn вне поля для отображения контекста, предоставляя идентификатор.
ShowField	Необязательный текст. Указывает поле для отображения в списке, на который приведена ссылка в поле Lookup. Если этот атрибут не указан, то по умолчанию будет отображаться значение, содержащееся в поле Title.
StripwS	Необязательный логический. TRUE используется для удаления пробелов в начале и в конце возвращаемого элементом значения.
URLEncode	Необязательный логический. ЗНАЧЕНИЕ TRUE для преобразования специальных символов, таких как пробелы, в формат UTF-8 с кавычками, `%c3%ab` например для символа `ë`.
URLEncodeAsURL	Необязательный логический. Как URLEncode, но значение TRUE , чтобы указать, что кодируемая строка является компонентом пути URL-адреса, а не для кодирования косой черты (`/`).

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

Нет

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

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

Occurrences

Минимум: 0
Максимум: не ограничен (1 в Expr1, Expr2 и UrlBaseName)

Замечания

В случае поля подстановки с именем LookupTitle, указывающего на название элемента 1 в списке объявлений, <LookupColumn Name="LookupTitle"/> будет отображаться сообщение "Начало работы с SharePoint Foundation!", а <Column Name="LookupTitle"/> отрисовка "1".

Следовательно, в большинстве ситуаций, связанных с полями подстановки , используйте элемент LookupColumn вместо элемента Column . Единственный случай, когда стоит использовать элемент Column — это при необходимости чистой ссылки на идентификатор элемента в целевом списке, может быть, чтобы создать свою собственную ссылку на определенный элемент.

Пример

В следующем примере используется элемент LookupColumn для возвращения значения, используемого для создания полного URL-адреса страницы на сервере.

<HTML><![CDATA[ <a href="  ]]></HTML>
<HttpHost URLEncodeAsURL="TRUE" />
<LookupColumn URLEncodeAsURL="TRUE" />
<HTML><![CDATA[ ">  ]]></HTML>

См. также

Элемент Column (View)

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