Sharepoint自定义字段开发(Custom Field) Inside Microsoft Sharepoint 2010 读书笔记

本篇博客是inside microsoft sharepoint 2010的读书笔记，针对我感兴趣的章节，争取多发一些笔记，作为对知识的整理。

通过开发自定义字段可以实现自定义的验证逻辑和自定义的字段显示与编辑UI

但是自定义字段也有一些缺点：

1. 不能以sandbox方式部署

2. 可能存在与office软件集成的问题（本人未测试）

3. 在使用linq2sharepoint时可能也会有问题（本人未测试）

VS2010中没有提供自定义字段的Project模板，也没有Project Item模板。下图是Inside Sharepoint 2010附带的样例代码

关于这个project的结构，有几点值得说明：

1. 没有feature的定义，自定义字段是针对整个Farm级别的，我们无法指定它在某个范围内可见

2. xxxFieldControl和ascx用户控件并不是必须的，只有当你需要自定义的字段编辑/显示UI时才需要

3. 如果需要定制字段编辑UI，则需要创建xxxFieldControl和ascx控件，注意在ControlTemplates下没有子文件夹，这是因为sharepoint针对custom field不在子目录中检索用户控件，因此这个样例项目加上了特定的前缀。

4. 一个前缀为fldtypes*.xml的文件需要被部署到服务器的template\xml文件夹下，实际上sharepoint foundation内置的字段类型定义xml也存放在这个文件夹下：fldtypes.xml，另外Sharepoint的server版中还有一些其他的自定义字段，例如dtypes_hold.xml, fldtypes_publishing.xml...

这个文件的结构是这样的：

实际上还有几个属性用来控制这个自定义字段的可见范围： ShowInListCreate, ShowInDocumentLibraryCreate, ShowInSurveyCreate, ShowInColumnTemplateCreate

创建一个最简单的Custom Field

代码说明

1. 必须继承自某个系统内置的字段基类，有两个必须有的构造函数(SPFieldCollection fields, string fieldName)和(SPFieldCollection fields, string typeName, string displayName)

2. override必要的基类属性、方法，上面的代码想要创建一个员工入职日期自定义字段，内含的业务逻辑是入职日期必须是周一

OnAdded：当用户完成字段添加后执行的代码

DefaultValue：如果用户在编辑界面中没有输入任何日期时执行该代码（这个属性只有get）

GetValidatedString：验证用户输入时执行，如果用户输入的数据不符合逻辑，可以抛异常throw new SPFieldValidationException("Employee start date must be a Monday"); Sharepoint会自动结果该异常并给出友好提示

另外，注意GetValidatedString的返回值是string，即使该字段的实际类型是DateTime。因此需要做些必要的转换，在sharepoint中，日期的标准字符串表示是ISO8601格式，SPUtility.CreateISO8601DateTimeFromSystemDateTime(startDate);

为自定义字段提供编辑/查看UI

简单来说，就是要额外定义用户控件、FieldControl，并在这三者之间建立起关联。

1. 用户控件

<SharePoint:RenderingTemplate ID="EmployeeStatusRenderingTemplate" runat="server"> 
<Template>
<asp:RadioButtonList ID="lstEmployeeStatus" runat="server" CssClass="ms-authoringcontrols" />
</Template>
</SharePoint:RenderingTemplate>

2. FieldControl