Windows SharePoint Service 3.0提供了自定义列表字段的接口,开发人员可以完全自主的开发所需要的列表字段类型,并且可对这种字段类型的编辑方式、显示方式完全控制。
注:感谢Todd Bleeker提供样例代码。
Part 1:自定义列表字段类型功能展示
前提:一种名为USAddress的自定义列表字段类型已经部署在网站上了,这种字段可以让用户按指定的格式输入地址,并对城市栏有输入限制。具体的开发和部署方法,参加本文Part 2
在网站设置里,找到Site Column Gallery,点击Create,添加一个新的Site Column:
将Site Column的名称设为“Mail Address”,字段类型选择“US Address”,点击OK:
回到网站,进入一个样例列表,点击列表设置:
用“Add from existing site columns”的方式添加一个新的字段:
选中刚刚添加的名为Mail Address的Site Column:
确定后,回到此列表,添加新条目,可以看到Mail Address字段。填写的时候,如果City栏填了“Redmond”,点击OK时会报数据合法性错误,此合法性判断是在开发此列表字段类型的时候由开发人员写入代码中的。而用于输入数据的几个文本框的格式和位置也可以由开发人员根据需要进行定制:
添加了新的条目之后,此字段内容的显示也在我们的控制之中。这个例子里,我们让此地址分行显示:
查看条目内容的页面格式也如此:
借助这种自定义列表字段类型的方法,我们可以更大的发挥sharepoint列表的功能,做出复杂的列表数据驱动的应用程序。
Part 2:自定义列表字段类型的开发和部署
目前发布的WSS3.0的SDK对此开发内容的介绍十分简略,而且没有完整的样例提供。幸运的是,我找到了这个例子:)
开发自定义列表字段类型的时候,我们需要3个文件:
1、一个放到GAC中的DLL,这个程序集中描述了你的自定义字段类和自定义字段值类,以及用于编辑此字段内容的控件集。
2、一个用户控件文件(ascx),这个文件描述了用于编辑和新建此种字段数据时所需的控件(文本框样式等等)
<%@ Control Language="C#" Debug=true %>
<%@Assembly Name="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@Register TagPrefix="SharePoint" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" namespace="Microsoft.SharePoint.WebControls"%>
![]()
<SharePoint:RenderingTemplate ID="USAddressField" runat="server">
<Template>
<asp:TextBox ID="addressBox" MaxLength="255" Size="50" runat="server"/><br>
<asp:TextBox ID="cityBox" MaxLength="50" Size="15" runat="server"/>
<asp:TextBox ID="stateBox" MaxLength="2" Size="2" runat="server"/>
<asp:TextBox ID="zipBox" MaxLength="5" Size="5" runat="server"/><br>
</Template>
</SharePoint:RenderingTemplate>
![]()
3、一个用来描述此字段类型的XML文件,这个文件的文件名必须以“fldtypes_”开头,遵从的schema请参考sharepoint的SDK:
http://msdn2.microsoft.com/en-us/library/ms415141.aspx
部署方法:
1、将编译好的强命名DLL拖放至GAC中
2、将ascx文件拷贝至:C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES
3、将xml文件拷贝至:C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML
4、重启IIS即可
样例代码下载:
http://www.gotdotnet.com/workspaces/workspace.aspx?id=633be800-ded5-49ea-b84d-302ce111811e