Элемент LookupColumn (View)

Статья
04/21/2015

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

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

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

Выполняет практически те же функции, что и элемент 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	Необязательный атрибут типа Boolean. Значение TRUE используется для выполнения преобразования внедренных символов для отображения их в веб-браузере в виде текста. Другими словами, символы, похожие на HTML-теги, преобразуются в логические объекты.
IncludeVersions	Необязательный атрибут типа Boolean.
Name	Обязательный атрибут типа Text. В этом поле указано имя столбца подстановки. Позволяет использовать элемент LookupColumn вне поля для отображения контекста, предоставляя идентификатор.
ShowField	Необязательный атрибут типа Text. Указывает поле для отображения в списке, на который приведена ссылка в поле Lookup. Если этот атрибут не указан, то по умолчанию будет отображаться значение, содержащееся в поле Title.
StripWS	Необязательный атрибут типа Boolean. Значение TRUE используется для удаления пробелов в начале и конце значения, возвращаемого элементом.
URLEncode	Необязательный атрибут типа Boolean. Значение TRUE используется для преобразования специальных символов (например, пробелов) в символы UTF-8, заключенные в кавычки; например "%c3%ab" для буквы "ё".
URLEncodeAsURL	Необязательный атрибут типа Boolean. Аналогичен URLEncode, но значение TRUE используется, чтобы указать принадлежность кодируемой строки к компонентам пути URL-адреса и чтобы косая черта ("/") не кодировалась.

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

Нет

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

Много

Вхождения

Минимум: 0

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

Примечания

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

Пример

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

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

См. также

Ссылка

Элемент Column (View)

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