新增功能:自定义字段呈现增强功能

上次修改时间: 2010年4月14日

适用范围: SharePoint Foundation 2010

本文内容
列表视图上的 XSLT 样式表呈现
RenderPattern 元素现在已过时
PropertySchema 元素现在已过时
向后兼容性

Microsoft SharePoint Foundation 2010 对定义自定义字段类型如何呈现的方式进行了两项重大更改。

列表视图上的 XSLT 样式表呈现

在 Windows SharePoint Services 3.0 中,字段通过字段定义文件 fldtypes*.xml 中的 RenderPattern 元素呈现在列表视图页面上。而在 SharePoint Foundation 2010 中,字段通过 XSLT 样式表呈现在列表视图页面上。因此,现在您可以通过创建自定义 XSLT 样式表(而不是向字段类型定义中添加自定义 RenderPattern 元素)来定义自定义字段类型的呈现。有关字段类型定义的详细信息,请参阅如何:创建自定义字段类型定义了解 FldTypes.xml 文件。有关 XSLT 呈现及其定义方法的详细信息,请参阅 XSLT 列表视图呈现系统概述如何:自定义列表视图中字段的呈现方式

RenderPattern 元素现在已过时

在 Windows SharePoint Services 3.0 中,通常依靠字段定义文件中的 RenderPattern 元素在显示模式中呈现字段。尽管很少见,但还可以通过 RenderPattern 元素在编辑和新建模式中呈现字段。通过名为 RenderingTemplate 的用户控件 (ASCX) 在"编辑"和"新建"模式中呈现字段更为常见,并且使用用户控件还可以在显示模式中呈现字段。而 SharePoint Foundation 2010 中,对于所有三个模式,自定义字段应始终通过用户控件呈现。尽管某些长久的内置字段仍使用 RenderPattern 元素,但对于自定义字段的开发,RenderPattern 元素已过时。

PropertySchema 元素现在已过时

在 Windows SharePoint Services 3.0 中,当自定义字段具有可变属性(即在不同列表上有不同值的属性)时,则需要在"新建网站栏"、"更改网站栏"、"创建栏"和"更改栏"页上有一个控件,用户才能设置该属性的值。自定义字段设计者可用于定义此控件的呈现的其中一种方式是通过字段定义文件中的 PropertySchema 元素。该方法现在已过时。您应创建一个编辑控件作为用户控件 (ASCX)。 通过设置 FieldEditorUserControl 属性,将您的自定义字段指向该用户控件。有关这类编辑器控件的详细信息,请参阅自定义字段类型属性呈现字段类型属性的编辑器控件

向后兼容性

如果没有用于字段的用户控件(RenderingTemplate),运行时会在字段类型定义文件中查找 RenderPattern 元素,如果找到,会使用该元素。此行为的一种含义是:对于"显示"、"编辑"和"新建"模式,您为 SharePoint Foundation 2010 之前的版本创建的自定义字段仍可使用其具有 RenderPattern 元素的现有字段类型定义。

SharePoint Foundation 2010 不会通过使用旧式自定义字段的字段类型定义中的 RenderPattern 自动在列表视图 上呈现该字段。但是,如果不希望使用 XSLT 样式表为字段提供的默认呈现方式,则可以通过将 <Field Name="CAMLRendering">TRUE</Field> 元素添加至字段类型定义来重新启用 RenderPattern。有关详细信息,请参阅了解 FldTypes.xml 文件RenderPattern 元素(字段类型)

请参阅

概念

构造块:列和字段类型

自定义字段类型

如何:创建自定义字段类型

自定义字段类型属性呈现

字段类型属性的编辑器控件