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

上次修改时间: 2009年9月30日

适用范围: SharePoint Foundation 2010

字段类型的变量属性的编辑器控件可替代 PropertySchema 元素(字段类型)使用,以在"新建网站栏"、"更改网站栏"、"创建栏"和"更改栏"页上呈现字段属性。有关这两个选项的概述以及何时使用每个方法的讨论,请参阅自定义字段类型属性呈现

创建编辑器控件

编辑器控件在 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates 下的一个 .ascx 文件和一个代码隐藏文件中定义,这两个文件将与自定义字段类编译为同一程序集。除了呈现该字段的属性,编辑器控件还支持使用特殊函数设置这些属性的列创建者,这些函数包括复杂的计算逻辑、查找数据源中的值和自定义数据验证等。

注意   我们建议您使用以下命名约定来命名您的编辑器控件类:

字段类型名称FieldEditor

例如,TargetDateFieldEditor 或 RegularExpressionFieldEditor。按照此约定,您的 .ascx 文件将被命名为 字段类型名称FieldEditor.ascx 并将从代码隐藏类 字段类型名称FieldEditor 继承。

IFieldEditor 接口

要用作字段编辑器用户控件,代码隐藏类必须执行下列操作:

IFieldEditor 接口包括以下属性和方法。单击各个名称可进一步了解如何实现各个属性或方法。

  • DisplayAsNewSection   使用此属性来指定是否希望该控件显示在"新建网站栏"、"更改网站栏"、"创建栏"和"更改栏"页面上的"其他栏设置"部分,或者仅显示在一个新部分中。

  • OnSaveChange   使用此方法来验证列的创建者或列的编辑者对字段(列)属性所做的更改,并保存更改。

  • InitializeWithField   使用此方法通过默认值或字段(列)的当前属性值来初始化编辑器控件。

请参阅

概念

自定义字段类型

如何:创建自定义字段类

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