通过

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"
/>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性

说明

**BaseType**

仅供内部使用。

**Id**

必需 **Text**。 指定内容类型的内容类型 ID。 内容类型 ID 具有特定的格式。 如果分配的 ID 属性的值的格式不正确，则激活功能时将收到错误。 有关详细信息，请参阅Content Type IDs。

**名字**

必需 **Text**。 指定内容类型名称。 该值可以是对格式为“$Resources：String”的资源的引用。 有关详细信息，请参阅 本地化 SharePoint 解决方案。

名称本身不能超过 128 个字符，并且不能包含字符 '\ / ： * ？ “ # % < > { } |~ &'， ('.连续两个句点。') 或特殊字符（如选项卡）。

如果添加内容类型的集合中存在另一个同名内容类型，则会出现错误。

**描述**

可选 **Text**。 提供要显示在 SharePoint Foundation 用户界面中的内容类型的说明。 该值可以是对格式为“$Resources：String”的资源的引用。

**DocumentTemplate**

已过时。 使用 DocumentTemplate 元素。

**FeatureId**

可选 **Text**。 提供与内容类型相关联的功能的 ID。 其值应该为 GUID 结构的字符串表示形式，包括大括号。

**组**

可选 **Text**。 指定内容类型分配到的内容类型组。 内容类型组是用户定义的组，可帮助您将内容类型分组到逻辑类别中。 该值可以是对格式为“$Resources：String”的资源的引用。

**隐藏**

可选 **Boolean**。 **TRUE**，将内容类型定义为隐藏。 如果将内容类型定义为隐藏，SharePoint Foundation 不会在列表视图中的“新建”按钮上显示该内容类型。

如果未包含此属性，SharePoint Foundation 会将内容类型视为属性设置为 FALSE。

**继承**

可选 **Boolean**。 此属性的值确定创建时内容类型是否从其父内容类型继承字段。

如果“继承”为 TRUE，则子内容类型继承父级中的所有字段，包括用户添加的字段。

如果“继承”为 FALSE 或不存在，并且父内容类型为内置类型，则子内容类型仅继承安装 SharePoint Foundation 时父内容类型中的字段。 子内容类型不具有用户添加到父内容类型中的任何字段。

如果“继承”为 FALSE 或不存在，并且父内容类型由沙盒解决方案预配，则子级不会从父级继承任何字段。

**NewDocumentControl**

可选 **Text**。 用于新建此内容类型的文档的首选应用程序的编程标识符。

**覆盖**

可选 **Boolean**。 **TRUE**，用于覆盖具有相同 ID 的现有内容类型。

默认值为 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 内容类型可映射到文档库列表模板。

**版本**

保留供以后使用。

子元素

DocumentTemplate、FieldRefs、Folder、XMLDocuments

父元素

ContentTypes、Elements

示例

下面的示例是 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>

另请参阅