Элемент RenderPattern (Field Types)

Статья
04/21/2015

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

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

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

Важно!
В этом разделе описывается разметка, использовавшаяся в теперь устаревшем методе визуализации настраиваемых типов полей в представлениях списков и в формах отображения, редактирования и создания. Она предоставляется только, чтобы помочь пользователям, отлаживающим настраиваемый тип поля, первоначально разработанный для более ранней версии SharePoint Foundation. Сведения о рекомендуемых методах см. в разделах Практическое руководство. Создание шаблонов отображения полей и Практическое руководство. Создание настраиваемого типа поля. Настраиваемые поля, визуализация которых определяется с помощью разметки RenderPattern, все еще правильно отображаются на формах. Но SharePoint Foundation по умолчанию использует таблицы XSLT-стилей для визуализации полей в представлениях списков, даже для устаревших настраиваемых полей, визуализация которых в списках определяется с помощью RenderPattern. Чтобы включить визуализацию такого поля, элемент <Field Name="CAMLRendering">TRUE</Field> необходимо добавить в содержащий его элемент FieldTypes в файле определения типа поля (fldtype*.xml).

В этом разделе описывается разметка, использовавшаяся в теперь устаревшем методе визуализации настраиваемых типов полей в представлениях списков и в формах отображения, редактирования и создания. Она предоставляется только, чтобы помочь пользователям, отлаживающим настраиваемый тип поля, первоначально разработанный для более ранней версии SharePoint Foundation. Сведения о рекомендуемых методах см. в разделах Практическое руководство. Создание шаблонов отображения полей и Практическое руководство. Создание настраиваемого типа поля.

Настраиваемые поля, визуализация которых определяется с помощью разметки RenderPattern, все еще правильно отображаются на формах. Но SharePoint Foundation по умолчанию использует таблицы XSLT-стилей для визуализации полей в представлениях списков, даже для устаревших настраиваемых полей, визуализация которых в списках определяется с помощью RenderPattern. Чтобы включить визуализацию такого поля, элемент <Field Name="CAMLRendering">TRUE</Field> необходимо добавить в содержащий его элемент FieldTypes в файле определения типа поля (fldtype*.xml).

RenderPattern определяет фактический код Collaborative Application Markup Language (CAML), HTML и скрипта, который SharePoint Foundation может использовать для визуализации типа поля в пользовательском интерфейсе. Кроме того, в представлениях списков этот элемент визуализирует заголовки столбцов на основании выбранного типа поля.

<RenderPattern Name="Text">
</RenderPattern>

Атрибуты

Атрибут	Описание
Name	Обязательный атрибут типа String. Представляет имя шаблона отображения, определяемого в этом элементе RenderPattern. Допустимые значения: HeaderPattern. Определяет визуализацию заголовка столбца на страницах представлений списков при включенной визуализации CAML (путем включения элемента <Field Name="CAMLRendering">TRUE</Field> в содержащий элемент FieldTypes файла fldtypes.xml). DisplayPattern. Определяет визуализацию поля для формы отображения (элемент списка). Когда включена визуализация CAML (путем включения элемента <Field Name="CAMLRendering">TRUE</Field> в содержащий элемент FieldTypes файла fldtypes.xml), то DisplayPattern также определяет визуализацию поля на страницах представлений списков. EditPattern. Определяет отображение поля для формы Edit (элемент списка). NewPattern. Определяет отображение поля для формы New (элемент списка). PreviewDisplayPattern. Определяет, для использования в конструкторе веб-сайтов WYSIWYG (режим точного отображения), например SharePoint Designer, предварительный просмотр поля в режиме отображения с использованием вымышленных данных. PreviewEditPattern. Определяет, для использования в конструкторе веб-сайтов с режимом WYSIWYG, например SharePoint Designer, предварительный просмотр поля в режиме редактирования с использованием вымышленных данных. PreviewNewPattern. Определяет, для использования в конструкторе веб-сайтов с режимом WYSIWYG, например SharePoint Designer, предварительный просмотр поля в режиме создания с использованием вымышленных данных.

Name

Обязательный атрибут типа String. Представляет имя шаблона отображения, определяемого в этом элементе RenderPattern.

Допустимые значения:

HeaderPattern. Определяет визуализацию заголовка столбца на страницах представлений списков при включенной визуализации CAML (путем включения элемента <Field Name="CAMLRendering">TRUE</Field> в содержащий элемент FieldTypes файла fldtypes*.xml).
DisplayPattern. Определяет визуализацию поля для формы отображения (элемент списка). Когда включена визуализация CAML (путем включения элемента <Field Name="CAMLRendering">TRUE</Field> в содержащий элемент FieldTypes файла fldtypes*.xml), то DisplayPattern также определяет визуализацию поля на страницах представлений списков.
EditPattern. Определяет отображение поля для формы Edit (элемент списка).
NewPattern. Определяет отображение поля для формы New (элемент списка).
PreviewDisplayPattern. Определяет, для использования в конструкторе веб-сайтов WYSIWYG (режим точного отображения), например SharePoint Designer, предварительный просмотр поля в режиме отображения с использованием вымышленных данных.
PreviewEditPattern. Определяет, для использования в конструкторе веб-сайтов с режимом WYSIWYG, например SharePoint Designer, предварительный просмотр поля в режиме редактирования с использованием вымышленных данных.
PreviewNewPattern. Определяет, для использования в конструкторе веб-сайтов с режимом WYSIWYG, например SharePoint Designer, предварительный просмотр поля в режиме создания с использованием вымышленных данных.

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

Явно заданных нет, но данный элемент является контейнером разметки CAML из Схема View.

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

Элемент FieldType (Field Types)

Примечания

Наследование RenderPatterns

Если для типа поля не указан RenderPattern с конкретным значением Name, этот тип поля наследует RenderPattern с таким именем от его родительского типа поля.

HeaderPattern

Если включена визуализация CAML (см. выше), тип полей либо напрямую, либо с помощью наследования должен относиться к типу HeaderPattern элемента RenderPattern, в противном случае заголовок столбца поля не будет визуализироваться в представлениях списков. Разметка в HeaderPattern может быть достаточно простой, когда тип поля нельзя отсортировать или отфильтровать. Однако, если тип поля можно отсортировать или отфильтровать, то разметка может стать значительно сложнее, так как заголовок выступает не только в качестве подписи в столбцу, но и в качестве элемента управления раскрывающегося меню сортировки и фильтрации. Кроме того, поскольку для некоторых столбцов возможность сортировки и фильтрации может быть отключена (даже когда тип поля, на котором основан столбец, поддерживает их), в разметке должны использоваться элементы Switch, проверяющие доступность сортировки и фильтрации для данного столбца. Примеры см. в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML\FLDTYPES.XML.

DisplayPattern

Если включена визуализация CAML (см. выше), тип полей (с помощью наследования, если не напрямую) должен относиться к типу DisplayPattern элемента RenderPattern, чтобы это поле могло визуализироваться в представлениях списков. Это необязательно для визуализации поля в режиме отображения, например на странице отображения (элемент списка), так как поле также может визуализироваться в режиме отображения с помощью элемента управления визуализацией (ASCX-файл). Ни один из устаревших типов полей, поставляющихся с SharePoint Foundation, не использует элемент управления визуализацией для визуализации поля в режиме отображения, кроме типа DisplayPattern элемента RenderPattern.

Тип DisplayPattern элемента RenderPattern также может использоваться для визуализации поля в каждой строке представления списка. По умолчанию SharePoint Foundation использует разметку XSLT в файле fldtypes*.xsl, находящемся в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\XSL, для визуализации полей в представлениях списков. Но файл fldtypes*.xml в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML проверяется на предмет наличия атрибута <Field Name="CAMLRendering">TRUE</Field> в содержащем элементе FieldTypes для поля. Если этот атрибут присутствует, для визуализации полей в представлениях списков используется DisplayPattern.

Примечание
Два устаревших типа поля, входящих в SharePoint Foundation, не относятся к типу DisplayPattern элемента RenderPattern в FLDTYPES.XML: (1) поля ContentTypeId не отображаются никогда, (2) поля Computed отображаются в представлениях списков и в режиме отображения с помощью элемента DisplayPattern, расположенного в соответствующих элементах Field внутри файла schema.xml каждого списка, в котором отображаются эти поля.

Два устаревших типа поля, входящих в SharePoint Foundation, не относятся к типу DisplayPattern элемента RenderPattern в FLDTYPES.XML: (1) поля ContentTypeId не отображаются никогда, (2) поля Computed отображаются в представлениях списков и в режиме отображения с помощью элемента DisplayPattern, расположенного в соответствующих элементах Field внутри файла schema.xml каждого списка, в котором отображаются эти поля.

NewPattern и EditPattern

Типы NewPattern и EditPattern элемента RenderPattern использовались для отображения поля в режиме создания и редактирования, соответственно, если при создании или изменении элемента списка, содержащего данное поле, для поля не требовалась обработка или проверка значительного объема данных. Например, нельзя проверить произвольные поля примечаний, так как для них допустимым значением является любой текст. Аналогичным образом поля Choice и поля Lookup по определению ограничивают выбор пользователя только допустимыми значениями. Другие поля, например Currency и DateTime, требуют только минимальной проверки, которую можно выполнить в скрипте.

Примеры типов NewPattern и EditPattern элементов RenderPatternсм. в файле %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML\FLDTYPES.XML.

RenderPattern для настраиваемых типов полей, производных от MultiColumn

В разметке RenderPattern для настраиваемого поля MultiColumn атрибут SubcolumnNumber элемента Column используется, чтобы задать отдельный столбец в типе поля с несколькими столбцами. Дополнительные сведения о типах полей с несколькими столбцами см. в разделе Классы настраиваемых полей с множеством столбцов.

Пример

В следующем примере показано определение шаблона отображения для настраиваемого типа поля, производного от типа MultiColumn. Это поле используется для хранения адресов в Америке. В первом вложенном столбце хранится улица. Затем следует перевод строки в формате HTML. В следующем вложенном столбце хранится название города, после которого стоит запятая и пробел. В третьем вложенном столбце хранится область, после которой стоит пробел, а в последнем вложенном столбце хранится почтовый индекс.

<RenderPattern Name="DisplayPattern">
  <Switch>
    <Expr><Column/></Expr>
    <Case Value="">
    </Case>
    <Default>
      <Column SubColumnNumber="0" HTMLEncode="TRUE"/>
      <HTML><![CDATA[<BR>]]></HTML>
      <Column SubColumnNumber="1" HTMLEncode="TRUE"/>
      <HTML><![CDATA[, &nbsp;]]></HTML>
      <Column SubColumnNumber="2" HTMLEncode="TRUE"/>
      <HTML><![CDATA[ &nbsp;]]></HTML>
      <Column SubColumnNumber="3" HTMLEncode="TRUE"/>
      </Default>
  </Switch>
</RenderPattern>