WSS页面定制系列（4）--利用SmartForm和用户控件定制表单页面

sharepoint表单定制已经连续写了三篇文章：

WSS3.0开发--页面定制（1）--修改列表的表单页面

WSS页面定制系列（1）--如何启用表单页面的编辑模式

WSS页面定制系列（2）---定制单个列表的表单页面

按照计划，本篇应该讲述使用用用户控件定制表单了。

用用户控件定制表单的原理很简单：

用户控件里放置表单控件，然后采用QuickPart类似的机制来加载这个控件，并且设置表单控件的上下文信息。具体的实现机制以后讲述。

这里为简化大家的工作，发布一个写好的WebPart--SmartFormWebPart，SmartForm整合了前面几篇文章提到的模板定制方式和用户控件定制方式。

在文章后面可以找到下载链接。

为什么叫SmartForm呢？ 这个名字含义是：你可以写一个简单的用户控件，然后利用wss的功能，自动实现数据的增加，修改，查看，

简单的表单用户控件依靠wss实现了智能化～

SmartForm的使用介绍

SmartForm 通过加载模板文件,使sharepoint的列表表单页面可以按照我们的需要显示成任意的样子.

表单保存后,可以转向默认页面或者是指定的页面.

SmartForm支持两种模板文件：

1）通过RenderingTemplate，这种方式定制后的表单可以放到任何地方，包括表单页面，站点首页。但是不能内嵌代码。

2）通过UserControl，这种方式定制的表单只能放到表单页面（Dispform.aspx,EditForm.aspx,NewForm.aspx）, 用户控件内可以内嵌代码,写一些判断逻辑。

使用方法:

1)将SmartForm.dll加入gac.


2)添加SafeControl

修改站点的web.config文件,在SafeControls节点下添加以下配置:

<SafeControl Assembly="SmartForm, Version=1.0.0.0, Culture=neutral, PublicKeyToken=aff738ac50c8cf48" Namespace="CodeArt.SharePoint.SmartForm" TypeName="*" Safe="True" />

3)将SmartFormWebPart添加到站点

网站操作菜单->网站设置->web部件->新建->选中CodeArt.SharePoint.SmartForm.SmartFormWebPart,导入.

4)现在你可以到需要修改的页面,添加SmartFormWebPart了.

如果你发现表单页面没办法修改,请参考这篇文章--WSS页面定制系列（1）--如何启用表单页面的编辑模式

下面演示一下两种模板文件的开发和配置.

RenderingTemplate的使用.

用一个现实中的需求: 客户希望把某个调查直接放到页面上,这样,浏览用户就不需要点击链接转到另一个页面去填写调查而直接就可以在首页填写.

1)新建一个调查列表,名称为"SmartForm调查",并添加一个调查问题:关于SmartForm的调查

键入两个选项:

您需要SmartForm吗？

您认为SmartForm还有哪些需要改进的地方？

2)编写RenderingTemplate

把以下内容保持到"12\TEMPLATE\CONTROLTEMPLATES\CodeArt_SurveyRenderingTemplate.ascx

<%@ Control Language="C#" AutoEventWireup="false" %>

<%@ 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="HomeSurveyForm" runat="server">

<Template>

<TABLE class="ms-formtable" style="margin-top: 8px;" border=0 cellpadding=0 cellspacing=0 width=100%>

<SharePoint:SurveyFieldIterator ID="SurveyFieldIterator1" runat="server"/>

</TABLE>

<div align="center">

<asp:Button runat="Server" ID="btnSave" Text="提交" CommandName="SaveItem" />

</div>

</Template>

</SharePoint:RenderingTemplate>

2)重启IIS

3)在首页添加SmartFormWebPart.

通知主题:

<SharePoint:FormField ID="FormField1" runat="server" FieldName="Title" />

通知内容:

<SharePoint:FormField ID="FormField2" runat="server" FieldName="Body" />

<hr />

<div>

<asp:Button runat="server" ID="saveButton" CommandName="SaveItem" Text=" 保存 "></asp:Button>

<input type="button" value=" 返回 " onclick="history.back()" />

</div>

2)到某个通知列表的新建页面(NewForm.aspx),进入设计模式.

3)添加SmartFormWebPart,并设置它的属性:

模板控件路径为:~/_CONTROLTEMPLATES/CodeArt_NoticeControlTemplate.ascx

控件模式选择:New

此时，列表名称属性不需要指定，控件自动获取当前列表。

4)保存,可以看效果了.

通知主题:

<SharePoint:FormField ID="FormField1" runat="server" FieldName="Title" />

通知内容:

<SharePoint:FormField ID="FormField2" runat="server" FieldName="Body" />

<hr />

<div>

<asp:Button runat="server" ID="saveButton" CommandName="SaveItem" Text=" 保存 "></asp:Button>

<input type="button" value=" 返回 " onclick="history.back()" />

</div>

用用户控件来定制列表表单,你可以做任意操作,做什么只受限于你的思维~

备注:

SmartForm实现的两种方式的模板,用户控件模板优先级大于RenderingTemplate,即,如果同时指定了"呈现模板ID"和"模板控件路径",则"模板控件路径"起作用.

下载试用 ： http://files.cnblogs.com/jianyi0115/SmartFormWebPart.zip

压缩包中包括dll和两个示例模板文件，可以单击里面的deploy.cmd文件实现自动注册GAC和copy模板文件，但是SafeControl仍然需要手工修改。

后记：

SmartFormWebPart当前不支持在非列表页面（DispForm.aspx,EditForm.aspx,NewForm.aspx）使用控件模板，在首页这种地方只能使用RenderingTemplate。