Элемент ContentType (ContentType)
Область применения: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Определяет один тип контента.
Определение
<ContentType
BaseType="Text"
ID="Text"
Name="Text"
Description="Text"
DocumentTemplate="Text"
FeatureId="Text"
Group="Text"
Hidden="TRUE" | "FALSE"
Inherits="TRUE" | "FALSE"
ProgId="Text"
NewDocumentControl="Text"
Overwrite="TRUE" | "FALSE
PushDownChangedResourceFilesOnly="TRUE" | "FALSE
ReadOnly="TRUE" | "FALSE"
RequireClientRenderingOnNew="TRUE" | "FALSE"
ResourceFolder="Text"
Sealed="TRUE" | "FALSE"
V2ListTemplateName="Text"
Version="Integer"
/>
Элементы и атрибуты
В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
Атрибут |
Описание |
---|---|
**Basetype** |
Зарезервировано для внутреннего использования. |
**ID** |
Обязательный **Текст**. Задает идентификатор типа контента. Для идентификатора типа контента используется особый формат. Если значение атрибута **ID** имеет неправильный формат, при активации компонента появится сообщение об ошибке. Дополнительные сведения см. в разделе Content Type IDs. |
**Имя** |
Обязательный **Текст**. Задает имя типа контента. Значение может быть ссылкой на ресурс в формате "$Resources:String". Дополнительные сведения см. в статье Локализация решений SharePoint. Само имя не может быть длиннее 128 символов и не может содержать символы '\ / : * ? " # % < > { } | ~ &', два последовательных периода ('.. '), или специальные символы, такие как вкладка. Если в коллекции, в которую добавляется тип контента, существует другой тип контента с тем же именем, возникает ошибка. |
**Описание** |
Необязательный параметр **Text**. Предоставляет описание типа контента для отображения в пользовательском интерфейсе SharePoint Foundation. Значение может быть ссылкой на ресурс в формате "$Resources:String". |
**DocumentTemplate** |
Устаревшие. Используйте элемент DocumentTemplate. |
**FeatureId** |
Необязательный параметр **Text**. Предоставляет идентификатор компонента, с которым связан тип контента. Это значение должно быть строковым представлением структуры GUID, включая фигурные скобки. |
**Группы** |
Необязательный параметр **Text**. Указывает группу типа контента, которой назначен тип контента. Группы типов контента определяются пользователями и помогают упорядочить типы контента в логические категории. Значение может быть ссылкой на ресурс в формате "$Resources:String". |
**Скрытые** |
Необязательный параметр **Boolean**. **TRUE** для определения типа контента как скрытого. Если тип контента определен как скрытый, SharePoint Foundation не отображает этот тип контента на кнопке **Создать** в представлениях списка. Если этот атрибут не включен, SharePoint Foundation обрабатывает тип контента так, как если бы атрибуту было задано значение **FALSE***. |
**Наследует** |
Необязательный параметр **Boolean**. Значение этого атрибута определяет, наследует ли тип контента при своем создании поля от родительского типа контента. Если параметр **Inherits** имеет значение **TRUE***, дочерний тип контента наследует все поля, которые находятся в родительском элементе, включая поля, добавленные пользователями. Если параметр **Inherits** имеет значение **FALSE** или отсутствует, а родительский тип контента является встроенным типом, дочерний тип контента наследует только поля, которые были в родительском типе контента при установке SharePoint Foundation. Дочерний тип контента не будет содержать никаких полей, добавленных пользователями в родительский тип контента. Если параметр **Inherits** имеет значение **FALSE** или отсутствует и родительский тип контента был подготовлен изолированным решением, дочерний элемент не наследует никакие поля от родительского. |
**NewDocumentControl** |
Необязательный параметр **Text**. Программный идентификатор приложения, используемого по умолчанию для создания нового документа этого типа контента. |
**Перезаписать** |
Необязательный параметр **Boolean**. **TRUE** для перезаписи существующего типа контента с тем же идентификатором. Значение по умолчанию — **FALSE**. |
**Progid** |
Необязательный параметр **Text**. Программный идентификатор приложения, используемого по умолчанию \для открытия документа этого типа контента. Этот атрибут различен для приложений, сохраняющих файлы с заданным расширением файла. |
**PushDownChangedResourceFilesOnly** |
Необязательный параметр **Boolean**. **TRUE** для копирования только измененных файлов ресурсов в производные типы контента во время операции отправки. Значение по умолчанию — **FALSE**. |
**Readonly** |
Необязательный параметр **Boolean**. **TRUE***, чтобы указать, что тип контента нельзя изменить без явного удаления параметра только для чтения. Удалить ее можно в пользовательском интерфейсе или в коде. Дополнительные сведения см. в разделе Content Type Change Control. Если этот атрибут не включен, SharePoint Foundation обрабатывает тип контента так, как если бы атрибуту было задано значение **FALSE***. |
**RequireClientRenderingOnNew** |
Необязательный параметр **Boolean**. **TRUE*** для того, чтобы браузер использовал приложение, указанное атрибутом **ProgId** для создания нового элемента. Значение по умолчанию — **TRUE**. |
**ResourceFolder** |
Устаревшие. Используйте элемент Folder. |
**Запечатаны** |
Необязательный параметр **Boolean**. **TRUE** для предотвращения изменений этого типа контента. Значение этого атрибута нельзя изменить из пользовательского интерфейса, но при наличии достаточных прав его можно изменить в коде. Чтобы "распечатать" тип контента, необходимы права администратора семейства веб-сайтов. Если этот атрибут не включен, SharePoint Foundation обрабатывает тип контента так, как если бы атрибуту было задано значение **FALSE***. |
**V2ListTemplateName** |
Необязательный параметр **Text**. Указывает тип шаблона списка Windows SharePoint Services 2.0, которому соответствует этот тип контента. Например, тип контента документа соответствует шаблону списка библиотеки документов. |
**Версия** |
Зарезервировано для последующего использования. |
Дочерние элементы
Родительские элементы
Пример
Следующий пример является определением для типа контента Document.
<ContentType ID="0x0101"
Name="$Resources:Document"
Group="$Resources:Document_Content_Types"
Description="$Resources:DocumentCTDesc"
V2ListTemplateName="doclib"
Version="0">
<FieldRefs>
<RemoveFieldRef ID="{67df98f4-9dec-48ff-a553-29bece9c5bf4}" Name="Attachments" />
<!-- Attachments -->
<RemoveFieldRef ID="{f1e020bc-ba26-443f-bf2f-b68715017bbc}" Name="WorkflowVersion" />
<!-- WorkflowVersion -->
<RemoveFieldRef ID="{bc91a437-52e7-49e1-8c4e-4698904b2b6d}" Name="LinkTitleNoMenu" />
<!-- LinkTitleNoMenu -->
<RemoveFieldRef ID="{82642ec8-ef9b-478f-acf9-31f7d45fbc31}" Name="LinkTitle" />
<!-- LinkTitle -->
<RemoveFieldRef ID="{ae069f25-3ac2-4256-b9c3-15dbc15da0e0}" Name="GUID" />
<!-- GUID -->
<RemoveFieldRef ID="{de8beacf-5505-47cd-80a6-aa44e7ffe2f4}" Name="WorkflowInstanceID" />
<!-- WorkflowInstanceID -->
<FieldRef ID="{5f47e085-2150-41dc-b661-442f3027f552}" Name="SelectFilename" />
<!-- SelectFilename -->
<FieldRef ID="{8553196d-ec8d-4564-9861-3dbe931050c8}" Name="FileLeafRef" Required="TRUE"/>
<!-- FileLeafRef -->
<FieldRef ID="{8c06beca-0777-48f7-91c7-6da68bc07b69}" Name="Created" Hidden="TRUE" />
<!-- Created -->
<FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" Required="FALSE" ShowInNewForm="FALSE" ShowInEditForm="TRUE"/>
<!-- Title -->
<FieldRef ID="{28cf69c5-fa48-462a-b5cd-27b6f9d2bd5f}" Name="Modified" Hidden="TRUE" />
<!-- Modified -->
<FieldRef ID="{822c78e3-1ea9-4943-b449-57863ad33ca9}" Name="Modified_x0020_By" Hidden="FALSE"/>
<!-- Modified_x0020_By -->
<FieldRef ID="{4dd7e525-8d6b-4cb4-9d3e-44ee25f973eb}" Name="Created_x0020_By" Hidden="FALSE" />
<!-- Created_x0020_By -->
</FieldRefs>
<XmlDocuments>
<XmlDocument NamespaceURI="http://schemas.microsoft.com/sharepoint/v3/contenttype/forms">
<FormTemplates xmlns="http://schemas.microsoft.com/sharepoint/v3/contenttype/forms">
<Display>DocumentLibraryForm</Display>
<Edit>DocumentLibraryForm</Edit>
<New>DocumentLibraryForm</New>
</FormTemplates>
</XmlDocument>
</XmlDocuments>
</ContentType>