在SharePoint中编写调用Excel Services的Filter Consumer WebPart(1)

本文将举例说明如何在wssv3中创建一个Filter consumer WebPart 来显示头条新闻。这些头条新闻内容依赖于地理区域的筛选提供者WebPart中用户的选择。头条新闻WebPart将通过调用Microsoft Excel Services从一个Excel工作簿中得到。

下面是创建filter consumer WebPart的五大步骤

1. 在Visual Studio 2005中创建一个web control library项目。
2. 添加到Microsoft.SharePoint.dll的引用。
3. 设置assembly的版本号。
4. 为assembly添加强命名。
5. 编写头条新闻filter consumer webpart的代码。

在Visual Studio 2005中创建一个web control library项目

创建一个filter consumer WebPart最简单的方式是套用Visual Studio 2005的自定义Web控件模板。

下面是创建的步骤：

1. 文件->新建->项目，出现新建项目对话框。
2. 在项目类型中，选择C#，选择Windows类别。
3. 在模板选择中，选择web控件库。
4. 为项目指定一个名称NewsHeadlinesWebPart 。
5. 指定保存的位置，确定。现在，项目中包含一个名为WebCustomControl1.cs的代码文件。
6. 在解决方案浏览器中右击该文件，选重名名。将该文件重命名为NewsHeadlinesWebPart.cs。

添加必要的程序集的引用


我们将要编写的头条新闻筛选消费者WebPart是要从Microsoft.SharePoint.WebPartPages.WebPart类继承而来。因此，必须添加Windows SharePoint Services的程序集；由于使用到了Excel Services，还要引用Excel Services的程序集，以便允许使用其中的类。
下面的步骤是展示了如何直接连接到Excel Web Serivces库。之所以如此是因为头条新闻WebPart运行域SharePoint环境中，这与使用SOAP通过HTTP访问Web service的方式不同。在我们的这种场景下直接连接可以提供更高的性能和安全性，并允许我们的头条新文WebPart可以工作在所有的SharePoint拓扑结构下。而当我们创建独立的Web应用程序(Web应用程序并不运行在SharePoint中)时，实际上是真正用到Web service的接口。关于何时选择使用SOAP方式通过HTTP访问，何时直接连接到Excel Web Services DLL，您可以参考这篇MOSS SDK文章：Loop-back SOAP Calls and Direct Linking
如果Visual Studio运行在Office SharePoint Server 2007服务器上，请以下面的步骤进行引用：

1. 项目->添加引用，出现添加引用对话框。
2. 点击.NET标签，选择Excel Web Service 组件(Microsoft.Office.Excel.Server.WebServics.dll)。接着向下滚动，找到Windows SharePoint Services组件(Microsoft.SharePoint.dll)，按住Ctrl键，再选择。
3. 确定，完成引用的添加。

如果Visual Studio与Office SharePoint Server 2007不在同一台机器上，我们需要从一台装有Office SharePoint Server 2007的机器上拷贝该文件到我们的开发环境所在机器的项目文件夹下。默认情况下，Microsoft.SharePoint.dll和Microsoft.Office.Excel.Server.WebServics.dll位于装有SharePoint的机器的以下目录中：

拷贝过来后，将这两个文件添加到引用中。

添加到本地拷贝的程序集的引用

1. 项目->添加引用，出现添加引用对话框。
2. 点击浏览，导航到放Windows SharePoint Services和Excel  Web Service程序集文件的目录
   选中Microsoft.SharePoint.dll 和Microsoft.Office.Excel.Server.WebServices.dll 文件。
3. 确定，完成引用的添加。

如果要使Excel Web Service正常工作，还需要添加到System.Web.Services程序集的引用： 

1. 项目->添加引用，出现添加引用对话框。
2. 点击.NET标签，选择System.Web.Services 组件。
3. 确定，完成引用的添加。

设置WebPart程序集的版本号

默认情况下，自定义Web控件项目的AssemblyVersion属性设为每次重新编译时自动增加。Web部件页通过Web.config文件中注册的版本号来识别WebPart。如果AssemblyVersion属性设为每次重新编译时自动增加，当我们把WebPart导入到Web部件页后又重新编译了该WebPart,就会因为找不到程序集而出错了。避免字增的方法就是手工指定一个版本号。

为WebPart程序集手工指定版本号

1. 项目->NewsHeadlinesWebPart 属性。
2. 在项目属性页面中，点应用程序标签。
3. 点程序集信息
4. 在程序集信息对话框中，设定版本为1.0.0.0
5. 确定，保存。
6. 关闭项目属性页。

1. 项目->NewsHeadlinesWebPart 属性。
2. 在项目属性页面中，点签名标签。
3. 在选择一个强名key文件处，点新建。
4. 在创建强命名key文件对话框中，填写keypair文件名。取消下面的使用密码保护我的密钥的选择框。
5. 关闭项目属性页。

实现头条新闻Filter Consumer WebPart

下面我们将创建一个类实现头条新闻筛选消费者部件。在代码文件头部添加下列引用。

引用这些命名空间可以使我们方便的使用其中的类库和类型，而不必通过使用完整的命名空间路径来访问。