添加自定义字段类
网站栏已经为一般用户和开发者提供了非常好的可重用的能力。更进一步，你可以定义一个可重用的栏定义，这将为我们带来更大的灵活性。配合Microsoft SharePoint Foundation 2010，你可以将创建自定义字段类型的门槛降得很低。
下面是创建一个自定义字段类型的总体步骤。你也可以参考这个msdn How to Video 视频。
创建一个自定义字段控件的过程为：
1. 创建一个public 的自定义字段类型的类，并继承自某个内置的字段类型类，比如SPFieldBoolen，SPFieldChoice，或 SPFieldText。
2. 创建两个public的构造器，接收特定的参数，并传递给相同参数的父类的构造器。
3. 创建一个XML文件，作为该字段类型的部署文件。你必须将其部署到一个指定的目录中，并且需要在场级别激活该自定义字段类型。
创建自定义字段类
你必须把自定义字段类定义为public的，并且为其提供两个非默认的构造器。本例同时还展示了如何通过覆写GetValidatedString方法使用正则表达式验证字段的值。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30 |
using System; using System.Collections.Generic; using System.Linq; using System.Text; using Microsoft.SharePoint; namespace WingtipCustomFields { public class ProductCode : SPFieldText { public ProductCode(SPFieldCollection fields, string fName) : base(fields, fName) { } public ProductCode(SPFieldCollection fields, string tName, string dName) : base(fields, tName, dName) { } public override string DefaultValue { get { return “P001″; } } public override string GetValidatedString(object value) { if (!value.ToString().StartsWith(“P”)) { throw new SPFieldValidationException(“Product code must start with ‘P’”); } if (value.ToString().Length != 4) { throw new SPFieldValidationException(“Product code must be 4 chars”); } // 在写入内容数据库前总是转换成大写的 return value.ToString().ToUpper(); } }} |
创建该字段类型的部署文件
字段类型的部署文件包含了由 Collaborative Application Markup Language (CAML) 定义的自定义字段类型。你必须以这样的格式命名该文件 fieldtypes*.xml 并将其部署到14\TEMPLATE\XML 目录下。下面的例子文件被命名为 fldtypes_WingtipCustomFields.xml。
|
1
2
3
4
5
6
7
8
9
10
11
12
13 |
<FieldTypes> <FieldType> <Field Name="TypeName">ProductCode</Field> <Field Name="ParentType">Text</Field> <Field Name="TypeDisplayName">Product Code</Field> <Field Name="TypeShortDescription">Wingtip Product Code</Field> <Field Name="UserCreatable">TRUE</Field> <Field Name="FieldTypeClass"> WingtipCustomFields.ProductCode, $SharePoint.Project.AssemblyFullName$ </Field> </FieldType> </FieldTypes> |
注意 -
Microsoft Visual Studio 2010 中的SharePoint部署工具允许你使用 $SharePoint.Project.AssemblyFullName$ 占位符来表示实际的组件名称。当你编译源文件并打包成解决方案包时SharPoint会用实际的组件名称替换该占位符。
