字段类型属性的编辑器控件
上次修改时间: 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 接口
要用作字段编辑器用户控件,代码隐藏类必须执行下列操作:
从 UserControl 类或其派生类继承。
实现 IFieldEditor 接口。
IFieldEditor 接口包括以下属性和方法。单击各个名称可进一步了解如何实现各个属性或方法。
DisplayAsNewSection 使用此属性来指定是否希望该控件显示在"新建网站栏"、"更改网站栏"、"创建栏"和"更改栏"页面上的"其他栏设置"部分,或者仅显示在一个新部分中。
OnSaveChange 使用此方法来验证列的创建者或列的编辑者对字段(列)属性所做的更改,并保存更改。
InitializeWithField 使用此方法通过默认值或字段(列)的当前属性值来初始化编辑器控件。