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

Статья
04/21/2015

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

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

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

Представляет характеристику типа поля.

<Field
  Name="Text">
</Field>

Атрибуты

Атрибут	Описание
Name	Обязательный атрибут типа Text. Строка, представляющая имя определенного аспекта типа поля, который представляет элемент Field. Значением должна быть одна из строк, указанная в следующей таблице.

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

Отсутствуют

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

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

Примечания

Дочерние элементы Field для элементов FieldType настраиваются в файлах fldtypes*.xml в каталоге "%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML".

Каждый элемент FieldType имеет несколько обязательных и необязательных элементов Field, которые различаются по атрибуту Name. Эти элементы описаны в следующей таблице. В объектной модели тип поля представлен классом SPFieldTypeDefinition. У последнего класса есть свойство только для чтения, относящееся ко всем строкам таблицы, за исключением двух. (Исключениями являются InternalType и SQLType). Если не указано иное, имена свойств соответствуют значению соответствующего атрибута Name.

Значение атрибута Name элемента Field	Описание
AllowBaseTypeRendering	Необязательный атрибут типа Boolean. Значение по умолчанию — FALSE. Указывает, отображает ли клиентское приложение поле как базовый тип (также называемый ParentType), если ему не удается определить, как правильно отображать настраиваемый тип поля. Если задано значение TRUE и клиентское приложение не может правильно отобразить настраиваемый тип поля, то поле визуализируется как тип родительского поля SharePoint Foundation по умолчанию, от которого унаследовано это поле.
CAMLRendering	Необязательный атрибут типа Boolean. Значение по умолчанию — FALSE. Указывает, визуализируется ли поле в представлениях списков с помощью разметки CAML в элементе RenderPattern в любом другом месте родительского элемента FieldType. Значение по умолчанию FALSE означает, что поле визуализируется в представлениях списков с помощью XSL-преобразования в файле fldtypes*.xsl, что является стандартной системой визуализации поля в представлениях списков. (Но этот элемент не влияет на визуализацию поля в формах отображения, создания и редактирования. Элемент RenderPattern остается стандартным способом визуализации поля в форме отображения.)
FieldTypeClass	Необязательный аргумент типа String, тем не менее, необходимый для всех настраиваемых типов полей. Представляет строгое имя библиотеки классов типов полей. "FieldTypeClass" включает имя класса и имя сборки с атрибутами Version, Culture и PublicKeyToken, например <Field Name="FieldTypeClass">CustomFieldTypes.RegularExpression.RegularExpressionField, CustomFieldTypes.RegularExpression, Version=1.0.0.0, Culture=neutral, PublicKeyToken=57e55365ec0ce80a</Field> (для типов полей, встроенных в SharePoint Foundation, включено только полное имя класса).
FieldEditorUserControl	Необязательный атрибут типа String. Представляет относительный путь к файлу тип_поляFieldEditor.ascx, который определяет отображаемый элемент управления в SharePoint Foundation в разделе Дополнительные параметры столбца на странице Создать столбец сайта. С помощью этого элемента управления пользователи, создающие столбцы, могут указывать для конкретного столбца переменные свойства типа поля. Например, "/_controltemplates/RegularExpressionFieldEditor.ascx". Если элемент <Field Name="FieldEditorUserControl"> отсутствует, особые свойства типа поля визуализируются с помощью элемента Элемент PropertySchema (Field Types). FieldEditorUserControl должна быть фиксированной нелокализуемой строкой.
Filterable	Обязательное типа Boolean. Указывает, может ли список со столбцом на основе данного типа поля быть отфильтрован в соответствии со значением столбца, использующего этот тип. Если задано значение TRUE, заголовком столбца является элемент управления, который можно использовать для фильтрации списка.
InternalType	Необязательный атрибут типа String. Представляет внутренний базовый тип. Не используйте элемент <Field Name="InternalType"> в определениях настраиваемых типов полей.
ParentType	Обязательное типа String (но может быть пустая строка). Представляет имя типа, производным от которого является класс поля. Возможные значения в точности совпадают с возможными значениями для атрибута Type элемента Элемент Field (List). Если тип поля не является производным другого типа, значением является пустая строка: <Field Name="ParentType"></Field>. Всегда должна быть заполнена в настраиваемых типах полей. Все настраиваемые типы наследуют от другого типа В объектной модели SharePoint Foundation элемент ParentType называется BaseRenderingTypeName.
ShowOnListAuthoringPages	Необязательное типа Boolean. Значение по умолчанию — TRUE. Указывает, отображается ли этот тип поля для включения в списки. Если задано значение TRUE, SharePoint Foundation отображает этот тип поля на страницах разработки, чтобы пользователи могли включить этот тип поля в свои списки. В объектной модели SharePoint Foundation элемент ShowOnListAuthoringPages называется ShowOnListCreate.
ShowOnDocumentLibraryAuthoringPages	Необязательное типа Boolean. Значение по умолчанию — TRUE. Указывает, отображается ли этот тип поля для включения в библиотеки документов. Если задано значение TRUE, SharePoint Foundation отображает этот тип поля на страницах разработки библиотек документов, чтобы пользователи могли включить этот тип поля в свои библиотеки документов. В объектной модели SharePoint Foundation элемент ShowOnDocumentLibraryAuthoringPages называется ShowOnDocumentLibraryCreate.
ShowOnSurveyAuthoringPages	Необязательное типа Boolean. Значение по умолчанию — TRUE. Указывает, отображается ли этот тип поля для включения в исследования. Если задано значение TRUE, SharePoint Foundation отображает этот тип поля на страницах разработки исследования, чтобы пользователи могли включить этот тип поля в свои исследования. В объектной модели SharePoint Foundation элемент ShowOnSurveyAuthoringPages называется ShowOnSurveyCreate.
ShowOnColumnTemplateAuthoringPages	Необязательное типа Boolean. Значение по умолчанию — TRUE. Указывает, должен ли этот тип поля отображаться в качестве типа поля шаблона столбца. Если задано значение TRUE, SharePoint Foundation отображает этот тип поля на страницах разработки шаблонов столбцов, чтобы пользователи могли создавать шаблоны столбцов данного типа поля. В объектной модели SharePoint Foundation элемент ShowOnColumnTemplateAuthoringPages называется ShowOnColumnTemplateCreate.
SQLType	Необязательный атрибут типа String. Представляет тип данных SQL, который будет использоваться для хранения данных в базе данных контента. Не используйте элемент <Field Name="SQLType"> в определениях настраиваемых типов полей.
Sortable	Обязательный атрибут типа Boolean. Указывает, может ли список со столбцом на основе данного типа поля быть отсортирован в столбце, использующем этот тип. Если задано значение TRUE, заголовком столбца является элемент управления, который можно использовать для сортировки списка.
TypeDisplayName	Обязательный атрибут типа String. Представляет отображаемое имя типа поля в пользовательском интерфейсе. В SharePoint Foundation отображается в столбце Тип на странице Настройка (listedit.aspx). Используется вместо "TypeShortDescription", если последний отсутствует. "TypeDisplayName" должна быть локализуемой строкой.
TypeName	Обязательное типа String. Представляет имя типа поля. Среди всех имен типов полей в ферме серверов SharePoint оно должно быть уникальным. "TypeName" должна быть фиксированной нелокализуемой строкой.
TypeShortDescription	Необязательный атрибут типа String. Представляет краткое описание типа поля, отображаемого в пользовательском интерфейсе. В SharePoint Foundation он появляется с переключателем в разделе Имя и тип на страницах Создать столбец сайта и Создание столбца и в столбце Тип в разделе Коллекция столбцов сайта. Если элемент <Field Name="TypeShortDescription"> отсутствует, используется "TypeDisplayName". "TypeShortDescription" должна быть локализуемой строкой.
UserCreatable	Необязательное типа Boolean. Значение по умолчанию — TRUE, позволяющее пользователям добавлять в списки поля данного типа. Если задано значение FALSE, тип поля можно использовать в схемах списков, однако тип поля будет скрыт от пользователей в разделе Имя и тип на страницах Создание столбца сайта и Создание столбца.

Пример

В следующем примере определяется настраиваемый тип поля.

Важно!
Атрибут RenderPattern является устаревшим. Он показан здесь, только чтобы помочь в отладке настраиваемых полей, изначально разработанных для предшествующих версий SharePoint Foundation.

  <FieldType>
    <Field Name="TypeName">SocialSecurityNumber</Field>
    <Field Name="ParentType">Text</Field>
    <Field Name="TypeDisplayName">Social Security Number</Field>
    <Field Name="TypeShortDescription">Social Security Number (123456789, 123-45-6789)</Field>
    <Field Name="AllowBaseTypeRendering">TRUE</Field>
    <Field Name="FieldTypeClass">
      AdventureWorks.FieldTypes.SPFieldSSN, AdventureWorks.FieldTypes.SPFieldSSN,
      Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
    </Field>
    <RenderPattern Name="DisplayPattern">
        <Column HTMLEncode="TRUE" /> 
        <Column HTMLEncode="TRUE" UseRelatedField="TRUE"/> 
    </RenderPattern>
  </FieldType>