Элемент View (List)
Дата последнего изменения: 9 марта 2015 г.
Применимо к: SharePoint Foundation 2010
В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения
В определении списка (Schema.xml) определяет представление для списка на веб-сайте, основанного на Microsoft SharePoint Foundation, где каждый список может содержать ряд представлений.
.gif "Примечание") Примечание |
|---|
В SharePoint Foundation 2010 для определения представлений списков используется XSLT, а Схема представления сохранена для обратной совместимости. Сведения о представлениях списка XSLT см. в разделе Представления списков. |
<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 |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что представление является представлением "Слияние форм", используемым в библиотеке XML-форм. По умолчанию библиотека XML-форм использует представление "Слияние форм", которое изначально скрыто. При использовании XML-редактора для публикации файла свойств XML-формы (XFP) в библиотеке, в каталоге "Формы" вместе с шаблоном, используемым редактором, атрибут AggregateView определяет представление "Слияние форм". Данное представление можно сделать видимым или скрыть, в зависимости от того, поддерживается слияние данных шаблоном списка или определением библиотеки. |
BaseViewID |
Необязательный атрибут типа Integer. Указывает идентификатор основного представления. |
ContentTypeID |
Необязательный атрибут типа Text. Указывает идентификатор типа контента, с которым связано представление. |
CssStyleSheet |
Необязательный атрибут типа Text. |
DefaultView |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что данное представление является представлением по умолчанию. |
DefaultViewForContentType |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что данное представление является представлением по умолчанию для типа контента. |
DisplayName |
Необязательный атрибут типа Text. Задает имя представления для отображения на панели Быстрого запуска. |
FailIfEmpty |
Необязательный атрибут типа Boolean. Если представление не возвращает элементов, значение TRUE используется, чтобы возвращать пустую страницу и код ошибки HTTP вместо визуализации элемента ViewEmpty. Используется для программного управления представлениями из клиентского приложения, и, таким образом, клиентскому приложению не нужно выполнять синтаксический анализ документа, чтобы определить, что представление является пустым. |
FileDialog |
Необязательный атрибут типа Boolean. Значение TRUE указывает, что представление отображается в диалоговых окнах файла для приложений, используемых в контексте служб SharePoint Foundation, выполняющих синтаксический анализ HTML-кода вывода для определения содержимого списка. |
FPModified |
Необязательный атрибут типа Boolean. Значение TRUE используется в том случае, если представление было изменено посредством правки в редакторе веб-страниц, и настройка представления через пользовательский интерфейс SharePoint Foundation более невозможна. |
FreeForm |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания альтернативного формата поля для определенных типов полей при визуализации полей. В частности, данный атрибут задает выравнивание числовых столбцов, что особенно рекомендуется для настраиваемых типов представлений не в виде таблиц. |
Hidden |
Необязательный атрибут типа Boolean. Значение TRUE используется, чтобы скрыть представление. |
ImageUrl |
Необязательный атрибут типа Text. Указывает URL-адрес, относящийся к серверу, для изображения, отображаемого в области заголовка представления списка, например /_layouts/images/pgrpicon.png. |
IncludeRootFolder |
Необязательный атрибут типа Boolean. Значение TRUE используется, чтобы указать на то, что корневая папка возвращается в представлении списка. |
List |
Необязательный атрибут типа Integer или Text. Определяет тип списка. Данное значение может являться либо идентификатором шаблона для списка (целое число), либо URL-адресом для списка, указанным на сайте (строка). Рекомендуется использовать Text, поскольку Integer может быть недостаточно конкретным (например, если на сайте существует два списка сообщений и задан List=104). |
MobileDefaultView |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что стандартное представление списка SharePoint является мобильным представлением по умолчанию. В качестве мобильного представления по умолчанию можно задать только одно представление для каждого списка. |
MobileItemLimit |
Необязательный атрибут типа Integer. |
MobileUrl |
Необязательный атрибут типа Text. |
MobileView |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что стандартное представление списка SharePoint также является мобильным представлением. Данный атрибут не применяется к представлениям "Календарь", "Лист данных" и "Диаграмма Ганта". |
ModerationType |
Необязательный атрибут типа Text. Определяет тип утверждения содержимого, который может являться HideUnapproved, Contributor или Moderator. В представлении HideUnapproved от пользователей, которые имеют разрешение только на чтение элементов, скрываются неутвержденные черновые элементы. В представлении Contributor для текущего пользователя отображаются элементы, ждущие обработки или отклоненные. Представление Moderator доступно только для пользователей, которые имеют управляемые разрешения списка, и отображает ждущие обработки и отклоненные элементы для всех пользователей. |
Name |
Необязательный атрибут типа Text. Имя, присвоенное представлению; используется для выбора в пользовательском интерфейсе представления с другим именем, а также для ссылки на представление с присвоенным именем при определении фильтра для поля Lookup. |
OrderedView |
Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что данное представление упорядочено. |
PageType |
Необязательный атрибут типа Text. Определяет тип формы, в которой используется представление. Может принимать следующие значения:
|
Path |
Необязательный атрибут типа Text. Задает имя файла для представления. |
ReadOnly |
Необязательный атрибут типа Boolean. Значение TRUE используется для присвоения представлению свойства "только чтение". |
RecurrenceRowset |
Необязательный атрибут типа Boolean. Значение TRUE используется, чтобы развернуть повторяющиеся события в представлении и отобразить каждый экземпляр каждого повторяющегося события. По умолчанию используется значение FALSE. |
ReqAuth |
Необязательный атрибут типа Boolean. |
RequiresClientIntegration |
Необязательный атрибут типа Boolean. Значение TRUE используется для применения функций, которые запускают клиентские приложения; в противном случае пользователи должны будут работать с документами локально и загружать изменения в главную систему. |
RowLimit |
Необязательный атрибут типа Integer. Применяется только для типа представления HTML. Определяет максимальное количество рядов для визуализации на любой странице. При превышении ограничений в количестве рядов можно просмотреть все возвращаемые наборы записей с помощью кнопок Next и Previous. Если RowLimit не задано, количество возвращаемых по умолчанию рядов — 50. Если для типа представления задан атрибут "Нет", все ряды набора записей возвращаются в одном представлении. При визуализации представления переменным визуализации ViewHasNext и ViewHasPrev присваиваются значения TRUE или FALSE, в зависимости от того, достигнуто ли в текущем представлении ограничение по количеству рядов из набора данных. Данные переменные могут использоваться в последовательных определениях страницы для визуализации кнопок Next и Previous на странице, как показано в следующем примере: Непустые значения также присваиваются переменным NextPageURL и PrevPageURL при наличии содержимого постраничного просмотра (вперед и назад) из текущего отображения. Данные переменные можно использовать посредством создания кнопок Next и Previous, чтобы они содержали верный URL-адрес для доступа к следующей странице содержимого. |
Scope |
Необязательный атрибут типа Text. Указывает пошаговый диапазон для представления библиотеки докуентов. Может принимать следующие значения:
Если данный атрибут не задан, в представлении отображаются только файлы и вложенные папки указанной папки. Значение данного атрибута соответствует свойству Scope класса SPView. |
SetupPath |
Необязательный атрибут типа Text. Указывает путь к папке, относящийся к сайту, в каталоге установки, который содержит страницу ASPX для представления, например pages\viewpage.aspx. |
ShowHeaderUI |
Необязательный атрибут типа Boolean. FALSE для визуализации всех элементов FieldRef, используемых в режиме отображения заголовка без использования HTML в пользовательском интерфейсе. Иными словами, если выбран данный режим, пользовательский интерфейс не предоставляет функций сортировки и применения фильтра как для гиперссылок в заголовке столбца. По умолчанию используется значение TRUE. |
TabularView |
Необязательный атрибут типа Boolean. |
TargetId |
Необязательный атрибут типа Text. |
TargetType |
Необязательный атрибут типа Text.Может принимать значения List и ContentType. |
Threaded |
Необязательный атрибут типа Boolean. Значение TRUE используется для применения функции внутренней группировки в представлении. Поточное представление создается на базе встроенного столбца последовательной обработки (предполагается, что он предусмотрен для списка). Выполняется сортировка (как вторичная сортировка) представления на данном поле. Если для остальных столбцов представления задана сортировка или группировка, эти правила применяются до определения порядка сортировки столбца последовательной обработки. В результате все обсуждения, сгруппированные по теме, могут быть объединены в коллекцию, и последовательная обработка сообщений может отображаться под коллекцией. Если используется значение TRUE, элемент RowLimit будет иметь другое значение при использоваии в представлении списка панели поточной дискуссии. Вместо указания количества возвращаемых элементов, атрибут указывает количество возвращаемых потоков дискуссии, где поток может включать один или несколько элементов. Помимо присвоения атрибуту Threaded значения TRUE, для поточного представления может выполняться сортировка по идентификатору потока; в противном случае ограничение количества рядов не возымеет желаемого эффекта. |
ToolbarTemplate |
Необязательный атрибут типа Text. Задает имя предварительно определенного шаблона панели инструментов, который используется для панели инструментов представления. |
Type |
Необязательный атрибут типа Text. Указывает тип визуализации представления. Данный тип является стандартным нумерованным HTML-представлением, и ему можно присвоить значение HTML, Chart или Pivot. |
Url |
Необязательный атрибут типа Text. Задает URL-адрес для представления. |
WebPartOrder |
Необязательный атрибут типа Integer. Указывает вертикальное размещение веб-части в зоне. |
WebPartZoneID |
Необязательный атрибут типа Text. Задает зону для веб-части. |
Дочерние элементы
Родительские элементы
Вхождения
Минимум: 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>