Элемент View (List)
Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
В определении списка (Schema.xml) определяет представление списка на веб-сайте на основе Microsoft SharePoint Foundation, где каждый список может содержать несколько представлений.
Примечание.
SharePoint Foundation 2010 использует XSLT для определения представлений списка, а схема представления поддерживается для обеспечения обратной совместимости. Сведения о представлениях списков XSLT см. в разделе List Views.
<View
AggregateView = "TRUE" | "FALSE"
BaseViewID = "Integer"
ContentTypeID = "Text" CssStyleSheet = "Text"
DefaultView = "TRUE" | "FALSE"
DefaultViewForContentType = "TRUE" | "FALSE"
DisplayName = "Text"
FailIfEmpty = "TRUE" | "FALSE"
FileDialog = "TRUE" | "FALSE"
FPModified = "TRUE" | "FALSE"
FreeForm = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
ImageUrl = "Text"
IncludeRootFolder = "TRUE" | "FALSE"
List = "Integer" | "Text"
MobileDefaultView = "TRUE" | "FALSE" MobileItemLimit = "Integer" MobileUrl = "Text"
MobileView = "TRUE" | "FALSE"
ModerationType = "Text"
Name = "Text"
OrderedView = "TRUE" | "FALSE"
PageType = "Text"
Path = "Text"
ReadOnly = "TRUE" | "FALSE"
RecurrenceRowset = "TRUE" | "FALSE"
ReqAuth = "TRUE" | "FALSE"
RequiresClientIntegration = "TRUE" | "FALSE"
RowLimit = "Integer"
Scope = "Text"
SetupPath = "Text"
ShowHeaderUI = "TRUE" | "FALSE" TabularView = "TRUE" | "FALSE"
TargetId = "Text"
TargetType = "List" | "ContentType"
Threaded = "TRUE" | "FALSE"
ToolbarTemplate = "Text"
Type = "HTML" | "Chart" | "Pivot"
Url = "Text"
WebPartOrder = "Integer"
WebPartZoneID = "Text">
</View>
Элементы и атрибуты
В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
| Атрибут | Описание |
|---|---|
| AggregateView |
Необязательный логический. Значение TRUE используется для указания на то, что представление является представлением "Слияние форм", используемым в библиотеке XML-форм. По умолчанию библиотека XML-форм использует представление "Слияние форм", которое изначально скрыто. При использовании XML-редактора для публикации файла свойств XML-формы (XFP) в библиотеке, в каталоге "Формы" вместе с шаблоном, используемым редактором, атрибут AggregateView определяет представление "Слияние форм". Данное представление можно сделать видимым или скрыть, в зависимости от того, поддерживается слияние данных шаблоном списка или определением библиотеки. |
| BaseViewID |
Необязательный атрибут типа Integer. Указывает идентификатор основного представления. |
| ContentTypeID |
Необязательный атрибут типа Text. Указывает идентификатор типа контента, с которым связано представление. |
| CssStyleSheet |
Необязательный текст. |
| DefaultView |
Необязательный логический. Значение TRUE используется для указания на то, что данное представление является представлением по умолчанию. |
| DefaultViewForContentType |
Необязательный логический. Значение TRUE используется для указания на то, что данное представление является представлением по умолчанию для типа контента. |
| DisplayName |
Необязательный атрибут типа Text. Задает имя представления для отображения на панели Быстрого запуска. |
| FailIfEmpty |
Необязательный логический. Если представление не возвращает элементов, значение TRUE используется, чтобы возвращать пустую страницу и код ошибки HTTP вместо визуализации элемента ViewEmpty. Используется для программного управления представлениями из клиентского приложения, и, таким образом, клиентскому приложению не нужно выполнять синтаксический анализ документа, чтобы определить, что представление является пустым. |
| FileDialog |
Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что представление отображается в диалоговых окнах файлов для приложений, используемых в контексте SharePoint Foundation, и которые анализируют выходной HTML-код для определения содержимого списка. |
| FPModified |
Необязательный логический. Значение TRUE , если представление было изменено путем редактирования в редакторе веб-страниц и представление больше не настраивается пользовательским интерфейсом SharePoint Foundation. |
| Freeform |
Необязательный логический. Значение TRUE используется для указания альтернативного формата поля для определенных типов полей при визуализации полей. В частности, данный атрибут задает выравнивание числовых столбцов, что особенно рекомендуется для настраиваемых типов представлений не в виде таблиц. |
| Hidden |
Необязательный логический. Значение TRUE используется, чтобы скрыть представление. |
| Imageurl |
Необязательный текст. Указывает ОТНОСИТЕЛЬНЫй URL-адрес для изображения, отображаемого в области заголовка представления списка, например /_layouts/images/pgrpicon.png. |
| IncludeRootFolder |
Необязательный логический. Значение TRUE используется, чтобы указать на то, что корневая папка возвращается в представлении списка. |
| List |
Необязательный атрибут типа Integer или Text. Определяет тип списка. Данное значение может являться либо идентификатором шаблона для списка (целое число), либо URL-адресом для списка, указанным на сайте (строка). Рекомендуется использовать Text, поскольку Integer может быть недостаточно конкретным (например, если на сайте существует два списка сообщений и задан List=104). |
| MobileDefaultView |
Необязательный логический. Значение TRUE используется для указания на то, что стандартное представление списка SharePoint является мобильным представлением по умолчанию. В качестве мобильного представления по умолчанию можно задать только одно представление для каждого списка. |
| MobileItemLimit |
Необязательное целое число. |
| MobileUrl |
Необязательный текст. |
| MobileView |
Необязательный логический. Значение TRUE используется для указания на то, что стандартное представление списка SharePoint также является мобильным представлением. Данный атрибут не применяется к представлениям "Календарь", "Лист данных" и "Диаграмма Ганта". |
| ModerationType |
Необязательный текст. Определяет тип утверждения содержимого, который может являться HideUnapproved, Contributor или Moderator. В представлении HideUnapproved от пользователей, которые имеют разрешение только на чтение элементов, скрываются неутвержденные черновые элементы. В представлении Contributor для текущего пользователя отображаются элементы, ждущие обработки, или отклоненные. Представление Moderator доступно только для пользователей, которые имеют управляемые разрешения списка, и отображает ждущие обработки и отклоненные элементы для всех пользователей. |
| Имя |
Необязательный текст. Имя, присвоенное представлению; используется для выбора в пользовательском интерфейсе представления с другим именем, а также для ссылки на представление с присвоенным именем при определении фильтра для поля Lookup. |
| OrderedView |
Необязательный логический. Значение TRUE используется для указания на то, что данное представление упорядочено. |
| PageType |
Необязательный атрибут типа Text. Определяет тип формы, в которой используется представление. Возможны следующие значения: DEFAULTVIEW Представление по умолчанию. DIALOGVIEW Представление диалогового окна "Файл". DISPLAYFORM Форма отображения для элементов списка. DISPLAYFORMDIALOG Форма отображения диалогового окна файла. EDITFORM Форма редактирования для элементов списка. EDITFORMDIALOG Форма редактирования для диалогового окна файла. НЕДОПУСТИМЫЙ Не используется. MAXITEMS Не используется. NEWFORM Новая форма для элементов списка. NEWFORMDIALOG Новая форма для диалогового окна "Файл". NORMALVIEW Обычное представление. ФОРМА РЕШЕНИЯ Форма решения. ВИД Представление, включая представление по умолчанию и обычное представление. |
| Путь |
Необязательный атрибут типа Text. Задает имя файла для представления. |
| ReadOnly |
Необязательный логический. Значение TRUE используется для присвоения представлению свойства "только чтение". |
| RecurrenceRowset |
Необязательный логический. Значение TRUE используется, чтобы развернуть повторяющиеся события в представлении и отобразить каждый экземпляр каждого повторяющегося события. Значение по умолчанию — FALSE. |
| ReqAuth |
Необязательный логический. |
| RequiresClientIntegration |
Необязательный логический. Значение TRUE используется для применения функций, которые запускают клиентские приложения; в противном случае пользователи должны будут работать с документами локально и загружать изменения в главную систему. |
| RowLimit |
Необязательный атрибут типа Integer. Применяется только для типа представления HTML. Определяет максимальное количество рядов для визуализации на любой странице. При превышении ограничений в количестве рядов можно просмотреть все возвращаемые наборы записей с помощью кнопок Next и Previous. Если RowLimit не задано, количество возвращаемых по умолчанию рядов — 50. Если для типа представления задано значение None , все строки набора записей возвращаются в одном представлении. При отображении представления переменные отрисовки ViewHasNext и ViewHasPrev имеют значение TRUE или FALSE в зависимости от того, достигло ли текущее представление предельного числа строк набора данных. Данные переменные могут использоваться в последовательных определениях страницы для визуализации кнопок Next и Previous на странице, как показано в следующем примере:XML<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"> <![CDATA[...Previous button defined here... ]]> </Case></Switch>Переменные NextPageURL и PrevPageURL также задаются как неблагообразные значения при наличии содержимого подкачки вперед или назад из текущего дисплея. Данные переменные можно использовать посредством создания кнопок Next и Previous, чтобы они содержали верный URL-адрес для доступа к следующей странице содержимого. |
| Scope |
Необязательный атрибут типа Text. Указывает пошаговый диапазон для представления библиотеки докуентов. Возможны следующие значения: FilesOnly — отображать только файлы указанной папки. Recursive — отображать все файлы всех папок. RecursiveAll — отображать все файлы и все вложенные папки всех папок. Если данный атрибут не задан, в представлении отображаются только файлы и вложенные папки указанной папки. Значение этого атрибута соответствует свойству Scope класса SPView . |
| SetupPath |
Необязательный текст. Указывает относительный путь к папке в каталоге установки, содержащей страницу ASPX для представления, например pages\viewpage.aspx. |
| ShowHeaderUI |
Необязательный логический. FALSE для визуализации всех элементов FieldRef, используемых в режиме отображения заголовка без использования HTML в пользовательском интерфейсе. Иными словами, если выбран данный режим, пользовательский интерфейс не предоставляет функций сортировки и применения фильтра как для гиперссылок в заголовке столбца. Значение по умолчанию — TRUE. |
| TabularView |
Необязательный логический. |
| TargetId |
Необязательный текст. |
| TargetType |
Необязательный текст. Возможные значения: List и ContentType. |
| Резьбовые |
Необязательный логический. Значение TRUE используется для применения функции внутренней группировки в представлении. Поточное представление создается на базе встроенного столбца последовательной обработки (предполагается, что он предусмотрен для списка). Выполняется сортировка (как вторичная сортировка) представления на данном поле. Если для остальных столбцов представления задана сортировка или группировка, эти правила применяются до определения порядка сортировки столбца последовательной обработки. В результате все обсуждения, сгруппированные по теме, могут быть объединены в коллекцию, и последовательная обработка сообщений может отображаться под коллекцией. Если используется значение TRUE, элемент RowLimit будет иметь другое значение при использоваии в представлении списка панели поточной дискуссии. Вместо указания количества возвращаемых элементов, атрибут указывает количество возвращаемых потоков дискуссии, где поток может включать один или несколько элементов. Помимо присвоения атрибуту Threaded значения TRUE, для поточного представления может выполняться сортировка по идентификатору потока; в противном случае ограничение количества рядов не возымеет желаемого эффекта. |
| ToolbarTemplate |
Необязательный атрибут типа Text. Задает имя предварительно определенного шаблона панели инструментов, который используется для панели инструментов представления. |
| Тип |
Необязательный атрибут типа Text. Указывает тип визуализации представления. Данный тип является стандартным нумерованным HTML-представлением, и ему можно присвоить значение HTML, Chart или Pivot. |
| Url |
Необязательный атрибут типа Text. Задает URL-адрес для представления. |
| WebPartOrder |
Необязательное целое число. Задает вертикальное расположение веб-части в пределах зоны. |
| WebPartZoneID |
Необязательный текст. Задает зону для веб-части. |
Дочерние элементы
- Агрегаты
- GroupByFooter
- GroupByHeader
- Соединения
- PagedClientCallbackRowset
- PagedRecurrenceRowset
- PagedRowset
- ParameterBindings
- ProjectedFields
- Query
- RowLimit
- RowLimitExceeded
- Toolbar
- ViewBidiHeader
- ViewBody
- ViewData
- ViewEmpty
- ViewFields
- ViewFooter
- ViewHeader
- ViewStyle
- XslLink
Родительские элементы
Occurrences
- Минимум: 0
- Максимум: без ограничений
Замечания
Основным типом представления для списка и сводных данных документа является представление HTML. Представление HTML, как правило, является столбцовым представлением, которое отображает сведения из одного или нескольких списков. Отображаемые данные описаны в полях, которые отображаются в представлении. Сведения о работе представлений в Microsoft SharePoint Foundation 2010 см. в разделе Представления списка.
Первичные атрибуты, которые определяют представление HTML:
- Имя.
- Характеристики источника данных (как правило, единичный список или библиотека документов).
- Фильтр, который следует применять к источнику данных.
- Коллекция полей для отображения.
- Порядок сортировки элементов для отображения. К специальным порядкам сортировки относится группировка.
- Шаблон HTML для визуализации представления.
Элемент View имеет первостепенное значение при визуализации страницы и создает SQL-запрос для полей, сортировок и фильтров, которые применяются в конкретном представлении. Элемент View выполняет итерацию через набор данных, возвращаемый запросом, и выполняет элемент ViewBody для каждого возвращаемого ряда. В элементе ViewBody можно использовать перечисление элемента Fields для обработки каждого из полей, или можно ссылаться на каждое поле в отдельности в элементе Field.
Каждое представление имеет внутреннее имя, которое, как правило, представлено глобальным уникальным идентификатором (GUID). Представление можно отобразить на странице с помощью тега <View/> .
Примеры
Следующий пример демонстрирует использование перечисления полей в рамках текстовой части представления и создание основной таблицы для отображения списка в браузере.
<View Name="MyCustomView">
<ViewHeader>
<HTML><![CDATA[<TABLE><TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TH>]]></HTML>
<Field/>
<HTML><![CDATA[</TH>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewHeader>
<ViewBody>
<HTML><![CDATA[<TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TD>]]></HTML>
<Field/>
<HTML><![CDATA[</TD>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewBody>
<ViewFooter>
<HTML><![CDATA[</TABLE>]]></HTML>
</ViewFooter>
Следует учесть, что в предыдущем разделе перечисление полей используется в рамках раздела ViewHeader для создания заголовков столбцов представления.
В следующем разделе примера раздел ViewFields включен в элемент View, чтобы указать, какие поля будут перечислены в представлении.
<ViewFields>
<FieldRef Name="Created_x0020_By"/>
<FieldRef Name="Last_x0020_Modified"/>
</ViewFields>
Примечание.
Если в представлении есть элемент Joins , поля из объединенных списков можно включить в ViewFields при условии, что они также представлены в элементе ProjectedFields .
В последнем разделе примера элемент Запрос используется, чтобы указать набор результатов, который соответствует определенным критериям (как в следующем примере, где возвращается список всех документов в библиотеке, созданных конкретным пользователем.
<Query>
<Where>
<Or>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
Mary
</Value>
</Eq>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
John
</Value>
</Eq>
</Or>
</Where>
<OrderBy>
<FieldRef Name="Last_x0020_Modified"/>
</OrderBy>
</Query>
</View>
В следующем примере представления отображается последовательность параграфов. Элемент Query задает не только порядок сортировки (в порядке даты изменения), но и фильтр (отображаются только элементы, у которых свойство Expires больше или равно сегодняшней дате).
<View Type="HTML" Name="Summary">
<ViewBody ExpandXML="TRUE">
<![CDATA[ <p><SPAN class=DocTitle><ows:Field Name="Title"/></SPAN>
(<ows:Field Name="Author"/>, <ows:Field Name="Modified"/>)
<ows:Limit><Field Name="Body"/></ows:Limit>
</p> ]]>
</ViewBody>
<Query>
<Where>
<Geq>
<FieldRef Name="Expires"/>
<Value Type="DateTime">
<Today/>
</Value>
</Geq>
</Where>
<OrderBy>
<FieldRef Name="Modified"/>
</OrderBy>
</Query>
<ViewFields>
<FieldRef Name="Summary"/>
<FieldRef Name="Author"/>
<FieldRef Name="Modified"/>
<FieldRef Name="Body"/>
</ViewFields>
</View>