MOSS 2007基础

MOSS 2007基础:开发自定义WebPartZDNet软件频道2007-10-31作者: | SunmoonfireBLOG
本文关键词:SharePoint WebPart MOSS 2007 MOSS
本文将介绍创建ASP风格的WebPart。最简单的步骤为创建一个类继承自System.Web.UI.WebControls.WebPart类,覆盖(override)方法RenderContents。如果您想要继续为WebPart增加属性(property),可以使用在ASP.NET中相同的办法。如下面的代码显示了一个登录后的用户名。本例假设Visual Studio 2005,Microsoft Office SharePoint Server(MOSS) 2007和WSS v3安装在同一台机器上。

  1、首先,打开Visual Studio 2005.

  我们将使用类库项目来创建ASP风格的WebPart。点击文件–〉新建项目。在项目类型中选择Visual C#,模板中选类库(Class Library)。在名称出输入TestWebParts。选择合适的保存路径。完成后点击确定。

  2、添加对System.Web.dll的引用

  在Solution Explorer中右键点击引用(References),选择添加引用 。

  选择.NET标签下的System.Web,将其添加到引用。

  3、添加必须的命名空间

  添加下面的命名空间

  using System.Web;

  using System.Web.UI;

  using System.Web.UI.WebControls;

  using System.Web.UI.WebControls.WebParts;

  4、继承自类System.Web .UI.WebControls.WebPart

  将Class1.cs重命名为SimpleWebPart,并添加继承System.Web.UI.WebControls.WebParts来创建ASP风格的WebPart。代码如下:

  

  using System;

  using System.Collections.Generic;

  using System.Text;

  using System.Web.UI;

  using System.Web.UI.WebControls.WebParts;

  namespace TestWebParts

  {

  public class SimpleWebPart:WebPart

  {

  protected override void RenderContents(HtmlTextWriter writer)

  {

  writer.Write(this.Context.User.Identity.Name);

  }

  }

  }

  

  我们必须重写RenderContents方法。如上所示。RenderContents方法将根据其参数writer所指定的内容来展示WebPart。writer参数是一个HtmlTextWriter,用于描述将要显示到客户端浏览器中的HTML内容。

  如果我们的WebPart中包含有子控件,我们还需要在这里调用基类的RenderContents方法或者在我们想要显示子控件的地方调用基类的RenderChildren方法,将子控件的内容输出到writer。

  上面的WebPart定义说明该代码并不依赖于Microsoft.SharePoint.dll。所以它既可以被用在ASP.NET应用程序中,也可以用在WSS v3站点。不过在大多数情况下,我们还是要在自定义WebPart中添加对Microsoft.SharePoint.dll的引用,因为这样就可以使用WSS v3提供的对象模型了。

  除支持ASP风格的WebPart外,WSS v3同时被设计为可以支持WSS v2环境下创建的WebPart。旧的WSS风格WebPart继承自Microsoft.SharePoint.dll中的WebPart基类,它是定义在Microsoft.SharePoint.WebPartPages命名空间下的。

  在WSS v2中的Microsoft.SharePoint.dll的WebPart类是继承自ASP.NET的Control类。如下图所示。

  但是,同时我们也可以看到,WSS v3中Microsoft.SharePoint.dll的WebPart类被修改为继承自ASP.NET的WebPart类。这种将一个组件的基类改为较新的版本的技术(versioning technique)就是rebasing。对Microsoft.SharePoint.dll中的WebPart类的rebasing是使WSS v3环境支持老的WSS风格WebPart的关键。

  如果查看一个WSS v3应用程序里的标准的Web.config文件,我们将发现里面包括了重新定向WSS v2的Microsoft.SharePoint.dll到WSS v3版的Microsoft.SharePoint.dll的配置元素。这个重定向与上面所说的rebasing配合起来共同保障了WSS v2环境下所写的WebPart的Dll运行在WSS v3环境中,而不必做任何的改动。

  因此,如果我们想要将一个WSS v2的WebPart项目转移到Visual Studio 2005中,我们可以使用与从前相同的方式继续扩充我们的代码,还是可以继续运行。同时,在转移到Visual Studio 2005时,我们还可以选择将项目中对Microsoft.SharePoint.dll的引用切换到WSS v3的版本。这样,该项目的WebPart就会转到上图右侧的WSS v3体系中。

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


%d bloggers like this: