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

Элемент View (Site)

  • Статья

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

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

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

Используется в определении сайта для указания представления списка для страницы в модуле.

<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

Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что представление является представлением "Слияние форм", используемым в библиотеке XML-форм. По умолчанию для библиотеки XML-форм предоставлено представление "Слияние форм", которое изначально скрыто. При использовании XML-редактора для публикации файла свойств XML-формы (XFP) в библиотеке, в каталоге "Формы" вместе с шаблоном, используемым редактором, атрибут AggregateView определяет представление "Слияние форм". Данное представление можно сделать видимым или скрыть, в зависимости от того, поддерживается ли слияние данных шаблоном списка или определением библиотеки.

BaseViewID

Необязательный атрибут типа Integer. Указывает идентификатор основного представления.

DefaultView

Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что данное представление является представлением по умолчанию.

DisplayName

Необязательный атрибут типа Text. Задает имя представления для отображения на панели Быстрого запуска.

FailIfEmpty

Необязательный атрибут типа Boolean. Если представление не возвращает элементов, значение TRUE используется, чтобы возвращать пустую страницу и код ошибки HTTP вместо визуализации элемента ViewEmpty. Используется для программного управления представлениями из клиентского приложения, и, таким образом, клиентскому приложению не нужно выполнять синтаксический анализ документа, чтобы определить, что представление является пустым.

FileDialog

Необязательный атрибут типа Boolean. Значение TRUE указывает, что представление отображается в диалоговых окнах файла для приложений, используемых в контексте служб Microsoft SharePoint Foundation, выполняющих синтаксический анализ HTML-кода вывода для определения содержимого списка.

FPModified

Необязательный атрибут типа Boolean. Значение TRUE используется в том случае, если представление было изменено посредством правки в редакторе веб-страниц, и настройка представления через пользовательский интерфейс SharePoint Foundation более невозможна.

FreeForm

Необязательный атрибут типа Boolean. Значение TRUE используется для указания альтернативного формата поля для визуализации определенных типов полей. В частности, данный атрибут задает выравнивание числовых столбцов, что особенно рекомендуется для настраиваемых типов представлений не в виде таблиц.

Hidden

Необязательный атрибут типа Boolean. Значение TRUE используется, чтобы скрыть представление.

List

Необязательный атрибут типа Integer или Text. Определяет тип списка. Данное значение может являться либо идентификатором шаблона для списка (целое число) либо URL-адресом для списка, указанным на сайте (строка). Рекомендуется использовать Text, поскольку Integer может быть недостаточно конкретным (например, если на сайте существует два списка сообщений и задан List=104).

Name

Необязательный атрибут типа Text. Имя, присвоенное представлению (используется для выбора в пользовательском интерфейсе представления с другим именем, а также для ссылки на представление с присвоенным именем при определении фильтра для поля Lookup).

OrderedView

Необязательный атрибут типа Boolean. Значение TRUE используется для указания на то, что данное представление упорядочено.

PageType

Необязательный атрибут типа Text. Определяет тип формы, в которой используется представление. Может принимать следующие значения:

  • DEFAULTVIEW   Представление по умолчанию.

  • DIALOGVIEW   Представление диалогового окна файла.

  • DISPLAYFORM   Отображаемая форма для элементов списка.

  • DISPLAYFORMDIALOG   Отображаемая форма для диалогового окна файла.

  • EDITFORM   Форма редактирования для элементов списка.

  • EDITFORMDIALOG   Форма редактирования для диалогового окна файла.

  • INVALID   Не используется.

  • MAXITEMS   Не используется.

  • NEWFORM   Новая форма для элементов списка.

  • NEWFORMDIALOG   Новая форма для диалогового окна файла.

  • NORMALVIEW   Стандартное представление.

  • SOLUTIONFORM   Форма решения.

  • VIEW   Представление (обычное и по умолчанию).

Path

Необязательный атрибут типа Text. Задает имя файла для представления.

ReadOnly

Необязательный атрибут типа Boolean. Значение TRUE используется для присвоения представлению свойства "только чтение".

RecurrenceRowset

Необязательный атрибут типа Boolean. Значение 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

Необязательный атрибут типа Boolean. FALSE для визуализации всех элементов FieldRef, используемых в режиме отображения заголовка без использования HTML в пользовательском интерфейсе. Иными словами, если выбран данный режим, пользовательский интерфейс не предоставляет функций сортировки и применения фильтра как для гиперссылок в заголовке столбца. По умолчанию используется значение TRUE.

Threaded

Необязательный атрибут типа Boolean. Значение TRUE используется для применения функции внутренней группировки в представлении. Поточное представление создается на базе встроенного столбца поточной обработки (предполагается, что он предусмотрен для списка). Выполняется сортировка (как вторичная сортировка) представления на данном поле.

Если используется значение TRUE, элемент RowLimit будет иметь другое значение при использовании в представлении списка панели поточной дискуссии. Вместо указания количества возвращаемых элементов атрибут указывает количество возвращаемых потоков дискуссии, где поток может включать один или несколько элементов. Помимо присвоения атрибуту Threaded значения TRUE для поточного представления может выполняться сортировка по идентификатору потока; в противном случае ограничение количества рядов не возымеет желаемого эффекта.

Type

Необязательный атрибут типа Text. Указывает тип визуализации представления. Данный тип является стандартным нумерованным HTML-представлением, и ему можно присвоить значение HTML, Chart, Pivot, GANTT или CALENDAR.

Url

Необязательный атрибут типа URL. Задает URL-адрес для представления.

WebPartOrder

Необязательный атрибут типа Integer. Указывает вертикальное размещение веб-части в зоне.

WebPartZoneID

Необязательный атрибут типа Text. Задает зону для веб-части.

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

Элемент

BinarySerializedWebPart

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

File

Вхождения

Минимум: 0

Максимум: без ограничений

Примечания

В разделе Элемент Module (Site) представлены примеры, демонстрирующие использование элемента View.