用户控件包装器的设计与实现-WebPart

用户控件包装器的设计与实现<o:p></o:p>

<o:p> </o:p>1.      引言<o:p></o:p>

SPS2003是一个安全、可伸缩的企业级门户服务器。可以利用它将SharePoint 站点、信息和应用程序汇集到一个单一的门户位置,用户可以通过门户内容和布局进行个性化的定制,更快地找到相关信息。目前，许多企业和政府部门已开始基于SPS2003服务在互联网上提供信息共享与应用服务，并构建跨企业的虚拟组织或虚拟企业，以实现大规模的资源共享。Web Part的自定义开发是实现基于SPS2003上的复杂应用的关键，微软官方提供的Web Partforvs2003模版是开发Web Part的标准编程环境，但是非常可惜，它不提供Web Part开发的可视化界面，对于复杂界面的Web Part的开发，将是一件非常吃力的事情。用户控件包装器巧妙的利用Web Partforvs2003模版，通过Web Part的属性将用户控件载入页面，通过菜单编辑用户控件，通过Web Part的数据传递实现用户控件之间的数据传递。<o:p></o:p>

2.      用户控件与Web Part的联系<o:p></o:p>

   ASP.NET为扩展服务器控件框架提供了两个抽象：用户控件和自定义控件。<o:p></o:p>

用户控件实质上是可插入其他页面中的 ASP.NET 页面，它们在一定程度上类似于传统 ASP 中使用的 Include 文件。使用 Visual Studio .NET，可以使用将控件拖到页面设计器的方式，将服务器控件拖到用户控件设计器上，从而轻松地构建用户控件。<o:p></o:p>

   ASP.NET自定义控件实质是一个从System.Web.UI.Control直接或间接继承于的类，它不受Visual Studio .NET中图形工具的支持。可以通过覆盖System.Web.UI.Control的CreateChildControls 方法，往自定义控件中添加服务器控件，定义其属性和事件。然后覆盖Control类的Render方法（直接继承于Control类）或覆盖WebControl类的RenderContent方法（继承于WebControl类），编写自己的代码来发出 html。<o:p></o:p>

    Web Part是SPS2003网站上的基本单元，它的概念类似于ASP.NET自定义控件，自己开发的Web Part将从Microsoft.SharePoint.Web PartPages.WebPart类继承，也是间接的继承了System.Web.UI.Control类。一样可以通过覆盖System.Web.UI.Control的CreateChildControls方法，添加服务器控件，定义其属性和事件。然后覆盖WebPart类的RenderWebPart方法，编写自己的代码发出html。<o:p></o:p>

     Web Part可以通过添加子控件的方式将用户控件和自身相联系，需要定义的大量用户界面和业务事件在用户控件中完成，Web Part起着选择用户控件、编辑用户控件和传递用户控件数据的作用。<o:p></o:p>

3.      用户控件包装器的具体实现<o:p></o:p>

3.1用户控件的载入和属性编辑<o:p></o:p>

    用户控件的载入和属性编辑都借助了Web Part的属性和工具面板。Web Part的属性分为默认属性和自定义属性。默认属性对Web Part的外观（如标题，高度，宽度），布局（如所在Web Part区域，显示的次序）和更高级的控制（如是否允许关闭，是否允许区域更改及选择访问Web Part的群体）进行了设置，是Web Part自带的属性。自定义属性是用户自已定义的属性，便于更灵活的编辑Web Part。<o:p></o:p>

工具面板由不同的Tool Part组成。<o:p></o:p>

默认属性对应WebPartToolPart类，自定义属性对应CustomPropertyToolPart类，这两个类都继承于ToolPart类。WebPart类的GetToolParts方法决定将哪些Tool Part显示在工具面板里。Web Part框架默认在该方法中将这两个类的实例写入ToolPart数组中，这两个属性将被工具面板中对应的Tool Part所编辑。同理，创建继承于ToolPart的类，就可以在工具面板中很好的控制Web Part中除了属性的内容。<o:p></o:p>

3.1.1 用户控件的载入<o:p></o:p>

用户控件的载入通过Web Part的自定义属性和工具面板实现。主要步骤如下：<o:p></o:p>

(1) 将用户控件对应的dll文件放入SPS2003的bin目录下，以待执行；<o:p></o:p>

(2) 创建WebPart的子类；<o:p></o:p>

(3) 在子类中添加一个自定义属性,用于保存载入的用户控件的完整路径。<o:p></o:p>

(4) 创建ToolPart的子类；<o:p></o:p>

(5)   将ascx文件放在SPS2003的某个虚拟目录下，在ToolPart子类中实现从该虚拟目录获取所有用户控件信息的方法;<o:p></o:p>

(6) 在ToolPart子类中实现一个返回一个字符串的方法，该字符串用于创建一个项值为用户控件完整路径，项的文本为用户控件名称或描述的下拉列表框；<o:p></o:p>

(7) ToolPart的子类覆盖虚方法RenderToolPart(HtmlTextWriter)，将第7步得到的字符串传入并被HtmlTextWriter对象写到浏览器上，用于在工具面板中显示包含所有用户控件的下拉列表框；<o:p></o:p>

(8) ToolPart的子类覆盖虚方法ApplyChanges（该虚方法用于用户点击工具面板中的”确定”或”应用”按钮时发生，将相应Tool Part中的值作编辑）将通过表单形式提交到服务器端的下拉列表框的选中值传给相应Web Part的保存用户控件路径的自定义属性，通过该属性载入用户控件；<o:p></o:p>

(9) WebPart的子类覆盖虚方法GetToolParts，在该方法中返回的ToolPart数组中加入第4步创建的类的实例；<o:p></o:p>

(10) WebPart的子类覆盖虚方法CreateChildControls，将载入的用户控件作为Web Part的子控件加入；<o:p></o:p>

(11) WebPart的子类覆盖虚方法RenderWebPart，通过RenderControl方法将该用户控件呈现到浏览器上。<o:p></o:p>

3.1.2 用户控件属性的编辑<o:p></o:p>

    当载入用户控件后，可以将用户控件属性映射到工具面板的一个Tool Part上，通过Tool Part来编辑用户控件属性。主要步骤如下：<o:p></o:p>

(1)     创建ToolPart的另一个子类，添加一个自定义属性，将载入的用户控件传给它;<o:p></o:p>

(2)  WebPart的子类覆盖WebPart的虚方法GetToolParts，在该方法中返回的ToolPart数组中加入第1步创建的类的实例；<o:p></o:p>

(3)     创建一个编辑不同类型属性的基类，将载入的用户控件及及时的http请求和要求编辑的属性传给它。在该类的子类中具体实现不同类型属性的编辑。基类中创建一个返回一个字符串的抽象方法，该字符串是编辑属性的html控件的html标记的字符串形式，在子类中对该方法进行具体实现；<o:p></o:p>

(4)     创建一个编辑用户控件所有属性的类，该类利用第3步创建的类，逐一将编辑用户控件属性的html控件封装进一个HtmlTable中；<o:p></o:p>

(5)     第1步创建的类覆盖ToolPart的虚方法RenderToolPart，利用第4步创建的类将对应用户控件属性信息的一个HtmlTable呈现到工具面板当中；<o:p></o:p>

以上步骤将用户控件的属性映射到工具面板的一个Tool Part当中，以下步骤将实现通过Tool Part编辑用户控件的属性。<o:p></o:p>

(6)     在WebPart的子类中添加一个自定义属性保存用户控件的所有属性值；<o:p></o:p>

(7)     在WebPart的子类中实现一个由外部传入的属性新值更新保存属性值的自定义属性的方法；<o:p></o:p>

(8)     在WebPart的子类中实现一个利用上述自定义属性更新用户控件属性的方法；<o:p></o:p>

(9)     在编辑不同类型属性的基类中创建一个返回Object类型的抽象函数，该返回值代表以表单形式提交到服务器端的编辑属性的html控件的值，该抽象函数在子类中得到具体的实现；<o:p></o:p>

(10) 第1步创建的类覆盖ToolPart的虚方法ApplyChanges，利用第9步创建的函数得到提交到服务器端的html控件值，将该值传给WebPart的子类更新保存属性值的自定义属性，然后利用该自定义属性更新用户控件的属性值。<o:p></o:p>

3.2           用户控件的编辑<o:p></o:p>

菜单是Web Part的一个重要组成部分，菜单的充分利用可以对Web Part的内容进行方便的编辑。Web Part自带的菜单可以实现对Web Part进行有效的编辑。这里介绍利用菜单实现对用户控件的复制和粘贴。<o:p></o:p>

确定一个用户控件的完整信息需要得到用户控件的路径及用户控件的所有属性。可以考虑将这两者复制到一个”剪切板”上。类的静态成员在该类的所有实例里拥有一样的值，巧妙地起到”剪切板”的作用，基于这个思想，在WebPart的子类中添加两个静态域，用于保存用户控件的信息。<o:p></o:p>

复制过程：<o:p></o:p>

(1) 添加复制菜单及相应菜单的服务器端函数；<o:p></o:p>

(2) 在函数中将WebPart子类中的自定义属性的值赋予添加的两个静态域；<o:p></o:p>

粘贴过程：<o:p></o:p>

(1) 添加粘贴菜单及相应菜单的服务器端函数；<o:p></o:p>

(2) 在函数中将两个静态域的值赋予WebPart子类的自定义属性；<o:p></o:p>

(3) 根据保存用户控件路径的自定义属性添加用户控件；<o:p></o:p>

(4) 根据保存用户控件属性的自定义属性赋予用户控件新的属性值。<o:p></o:p>

(5) 保存自定义属性的值，以便再次加载页面时用户控件的状态得以保留；<o:p></o:p>

3.3           用户控件之间的数值传递<o:p></o:p>

3.3.1 Web Part之间的数值传递<o:p></o:p>

用户控件之间的数值传递依赖于Web Part之间的数值传递。Web Part之间的数值通过实现Web Part框架提供的6对接口之一得以传递，这6对接口分别是：<o:p></o:p>

连接的接口对<o:p></o:p>	描述<o:p></o:p>