Элемент View (Site)
Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Используется в определении сайта для указания представления списка для страницы в модуле.
<View
AggregateView = "TRUE" | "FALSE"
BaseViewID = "Integer"
DefaultView = "TRUE" | "FALSE"
DisplayName = "Text"
FailIfEmpty = "TRUE" | "FALSE"
FileDialog = "TRUE" | "FALSE"
FPModified = "TRUE" | "FALSE"
FreeForm = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
List = "Integer" } "Text"
Name = "Text"
OrderedView = "TRUE" | "FALSE"
PageType = "Text"
Path = "Text"
ReadOnly = "TRUE" | "FALSE"
RecurrenceRowset = "TRUE" | "FALSE"
RowLimit = "Integer"
Scope = "Text"
ShowHeaderUI = "TRUE" | "FALSE"
Threaded = "TRUE" | "FALSE"
Type = "HTML" | "Chart" | "Pivot"
Url = "URL"
WebPartOrder = "Integer"
WebPartZoneID = "Text">
</View>
Элементы и атрибуты
В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
| Атрибут | Описание |
|---|---|
| AggregateView |
Необязательный логический. TRUE, чтобы указать, что представление является представлением объединения форм, используемым в библиотеке XML-форм. По умолчанию библиотека XML-форм наполняется представлением объединения форм, которое изначально скрыто. При использовании редактора XML для публикации файла свойств XML-форм (XFP) в каталоге форм в библиотеке наряду с шаблоном, используемым редактором, атрибут AggregateView определяет представление объединения форм, которое можно сделать видимым или скрытым в зависимости от того, поддерживает ли шаблон списка или определение для библиотеки объединение данных. |
| BaseViewID |
Необязательный атрибут типа Integer. Указывает идентификатор основного представления. |
| DefaultView |
Необязательный логический. Значение TRUE используется для указания на то, что данное представление является представлением по умолчанию. |
| DisplayName |
Необязательный атрибут типа Text. Задает имя представления для отображения на панели Быстрого запуска. |
| FailIfEmpty |
Необязательный логический. Если представление не возвращает элементов, значение TRUE используется, чтобы возвращать пустую страницу и код ошибки HTTP вместо визуализации элемента ViewEmpty. Используется для программного управления представлениями из клиентского приложения, и, таким образом, клиентскому приложению не нужно выполнять синтаксический анализ документа, чтобы определить, что представление является пустым. |
| FileDialog |
Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что представление отображается в диалоговых окнах файлов для приложений, используемых в контексте Microsoft SharePoint Foundation, которые анализируют выходной HTML-код для определения содержимого списка. |
| FPModified |
Необязательный логический. Значение TRUE , если представление было изменено путем редактирования в редакторе веб-страниц и представление больше не настраивается пользовательским интерфейсом SharePoint Foundation. |
| Freeform |
Необязательный логический. Значение TRUE используется для указания альтернативного формата поля для визуализации определенных типов полей. В частности, данный атрибут задает выравнивание числовых столбцов, что особенно рекомендуется для настраиваемых типов представлений не в виде таблиц. |
| Hidden |
Необязательный логический. Значение TRUE используется, чтобы скрыть представление. |
| List |
Необязательный атрибут типа Integer или Text. Определяет тип списка. Данное значение может являться либо идентификатором шаблона для списка (целое число), либо URL-адресом для списка, указанным на сайте (строка). Рекомендуется использовать Text, поскольку Integer может быть недостаточно конкретным (например, если на сайте существует два списка сообщений и задан List=104). |
| Имя |
Необязательный текст. Имя, присвоенное представлению (используется для выбора в пользовательском интерфейсе представления с другим именем, а также для ссылки на представление с присвоенным именем при определении фильтра для поля Lookup). |
| OrderedView |
Необязательный логический. Значение TRUE используется для указания на то, что данное представление упорядочено. |
| PageType |
Необязательный атрибут типа Text. Определяет тип формы, в которой используется представление. Возможны следующие значения: DEFAULTVIEW Представление по умолчанию. DIALOGVIEW Представление диалогового окна "Файл". DISPLAYFORM Форма отображения для элементов списка. DISPLAYFORMDIALOG Форма отображения диалогового окна файла. EDITFORM Форма редактирования для элементов списка. EDITFORMDIALOG Форма редактирования для диалогового окна файла. НЕДОПУСТИМЫЙ Не используется. MAXITEMS Не используется. NEWFORM Новая форма для элементов списка. NEWFORMDIALOG Новая форма для диалогового окна "Файл". NORMALVIEW Обычное представление. ФОРМА РЕШЕНИЯ Форма решения. ВИД Представление, включая представление по умолчанию и обычное представление. |
| Путь |
Необязательный атрибут типа Text. Задает имя файла для представления. |
| ReadOnly |
Необязательный логический. Значение TRUE используется для присвоения представлению свойства "только чтение". |
| RecurrenceRowset |
Необязательный логический. Значение TRUE используется, чтобы развернуть повторяющиеся события в представлении и отобразить каждый экземпляр каждого повторяющегося события. Значение по умолчанию — FALSE. |
| RowLimit |
Необязательный атрибут типа Integer. Применяется только для типа представления HTML. Определяет максимальное количество рядов для визуализации на любой странице. При превышении ограничений в количестве рядов можно просмотреть все остальные части возвращаемых наборов записей с помощью кнопок Next и Previous на странице. Если RowLimit не задано, количество возвращаемых по умолчанию рядов — 50. Если для типа представления задан атрибут "Нет", все ряды набора записей возвращаются в одном представлении. При отображении представления переменные отрисовки ViewHasNext и ViewHasPrev имеют значение TRUE или FALSE в зависимости от того, достигло ли текущее представление предельного числа строк набора данных. Данные переменные могут использоваться в последовательных определениях страницы для визуализации кнопок Next и Previous на странице, как показано в следующем примере:<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 . |
| ShowHeaderUI |
Необязательный логический. FALSE для визуализации всех элементов FieldRef, используемых в режиме отображения заголовка без использования HTML в пользовательском интерфейсе. Иными словами, если выбран данный режим, пользовательский интерфейс не предоставляет функций сортировки и применения фильтра как для гиперссылок в заголовке столбца. Значение по умолчанию — TRUE. |
| Резьбовые |
Необязательный логический. Значение TRUE используется для применения функции внутренней группировки в представлении. Поточное представление создается на базе встроенного столбца последовательной обработки (предполагается, что он предусмотрен для списка). Представление сортируется в этом поле как дополнительная сортировка. Если другие столбцы в представлении указаны как отсортированные или сгруппированные, то они применяются перед порядком сортировки столбца цепочек обсуждения. В результате этого все обсуждения, сгруппированные разделом, могут быть собраны вместе, а цепочки обсуждений сообщений могут отображаться в коллекции. Если используется значение TRUE, элемент RowLimit будет иметь другое значение при использоваии в представлении списка панели поточной дискуссии. Вместо указания количества возвращаемых элементов, атрибут указывает количество возвращаемых потоков дискуссии, где поток может включать один или несколько элементов. Помимо присвоения атрибуту Threaded значения TRUE для поточного представления может выполняться сортировка по идентификатору потока; в противном случае ограничение количества рядов не возымеет желаемого эффекта. |
| Тип |
Необязательный атрибут типа Text. Указывает тип визуализации представления. Данный тип является стандартным нумерованным HTML-представлением, и ему можно присвоить значение HTML, Chart, Pivot, GANTT или CALENDAR. |
| Url |
Необязательный атрибут типа URL. Задает URL-адрес для представления. |
| WebPartOrder |
Необязательное целое число. Задает вертикальное расположение веб-части в пределах зоны. |
| WebPartZoneID |
Необязательный текст. Задает зону для веб-части. |
Дочерние элементы
Родительские элементы
Occurrences
- Минимум: 0
- Максимум: без ограничений
Замечания
Пример использования элемента View см. в разделе Элемент Module (Site).