WSSv3 Technical Articles_使用Visual Studio 2005扩展创建Windows SharePoint Services 3.0 Web Part
摘要 ：学习使用 Microsoft Visual Studio 2005 extensions for Microsoft Windows SharePoint Services 3.0 中的项目模板加速 Web Part 开发。
Alex Malek, Microsoft Corporation
Andrew May, Microsoft Corporation
November 2006
<?XML:NAMESPACE PREFIX = O />

 

应用 ： Microsoft Windows SharePoint Services 3.0, Visual Stuidio 2005

 

内容 ：
Ø  介绍Microsoft Visual Studio 2005 extensions for Microsoft Windows SharePoint Services 3.0 Web Part开发
Ø  创建一个新的Web Part解决方案
Ø  自定义Web Part 解决方案Package
Ø  部署和调试Web Part
Ø  结论
Ø  其他资源

 

介绍Microsoft Visual Studio 2005 extensions for Microsoft Windows SharePoint Services 3.0 Web Part 开发

Microsoft Visual Studio 2005 extensions for Microsoft Windows SharePoint Services 3.0 包含的项目模板可以使你直接跳 Windows SharePoint Services 的开发环境中。此外，这个扩展包括的 Web Part 项目模板可以完成在 Windows SharePoint Services 中从 Microsoft ASP.NET Web Parts 创建、部署一直到测试。
这篇文章解释了如何使用 Web Part 项目模板开发、部署和测试 Windows SharePoint Services 3.0 的 ASP.NET Web Part 。
注意： 1
这篇文章假设已经安装并配置好了 Visual Studio 2005 extensions for Windows SharePoint Services 3.0 。可以从 Microsoft Download Center 下载 Windows SharePoint Services 3.0 Tools: Visual Studio 2005 Extensions 。

 

创建一个新的Web Part 解决方案

扩展中的 Web Part 项目模板是为 Windows SharePoint Services 3.0 的 Web Part 自定义的。
To Create a new Web Part solution

1 ．打开 Visual Studio 2005
2 ．在菜单中选择文件，新建，项目。
3 ．在项目类型中选择 Visual C# ，子类中选择 SharePoint 。
注意：
现在仅提供了 Microsoft Visual C# 关于 Web Part 的模板扩展。
4 ．在模板中选择 Web Part 。
5 ．为 Web Part 指定一个新的名字、位置或解决方案名称，然后点击确定。扩展将创建一个新的 Web Part 解决方案项目，其中包含以下内容：
l  引用了必要的 DLL 。
l  AssemblyInfo.cs 文件，它允许指定 Web Part 组件的公司和产品信息，还有版本信息。
l  Temporary.snk ，这是一个 Web Part 组件的临时签名文件。
注意：
这个临时的签名文件只是为了开发而使用。如果你的 Web Part 已经准备作为产品发布，需要生成一个自己使用的持久地签名文件。
l  添加了 Web Part 的 Visual C# 代码文件，名字和 Web Part 名字一样。默认情况下， Web Part 代码文件包含以下内容：
n  using 子句添加了必要的 System 和 Windows SharePoint Services 命名空间，例如： Microsoft.SharePoint ， Microsoft.SharePoint.WebControls 和 Microsoft.SharePoint.WebPartPages 。
n  一个空的 Web Part 类并继承自 System.Web.UI.WebControls.WebParts.WebPart 。
6 ． Web Part 类中添加需要的代码。

 

自定义Web Part 解决方案Package

Web Part 项目模板自动生成了 Web Part 作为 Windows SharePoint Services 3.0 的 Feature 部署并激活时包中需要的 XML 文件。 XML 文件中需要的 GUID 也一起自动生成了。
如果需要了解更多 Feature 的信息，请访问 Working With Features 。
扩展生成了 .webpart 还有 Feature 用到的 element.xml 文件。每个 Web Part 都有一个 .webpart 文件，它是一个描述 Web Part 的 XML 文件。这个文件可以使你的 Web Part 出现在 Windows SharePoint Services 的 Web Part 库中。
你可以通过在 SharePoing 解决方案的项目属性标签中修改解决方案、 Feature 、和 element 属性来自定义这些在 XML 中描述的信息，包括以下内容：
l  Solution  这个节点中的信息将被写入 Feature 中的 manifest.xml 文件。可以设置如下属性：
                   Name       Web Part 解决方案的名称。
l  Feature    这个节点中的信息将被写入 Feature 中的 feature.xml 文件。可以设置如下 feature 属性：
Folder Name   包含这些 Feature 需要的文件的文件夹的名称。
Title                    Feature 的标题。限制 255 个字符。
Description     对 Feature 的详细描述。
Version             版本号
Scope                Feature 的范围。可以为以下其中之一： Farm （服务器场）， WebApplication （应用程序）， Site （站点集）， Web （ Web 站点）。
关于 Feature Scope 的更多信息，请访问 Element Scope 。
Hidden              隐藏 Feature 。这个特性默认情况下为 False 。
Default Resource File      显示一个通用的资源文件来找到 Feature 的 XML 资源文件。
关于这些特性的更多信息， 请访问Feature Element（Feature） 。
l  Element   这个节点中的信息将被写入 Feature 中的 element.xml 文件。和上面提到的一样，这个文件包含的信息通常包含在 .webpart 文件中。可以设置如下 element 属性：

Title                                      希望 Web Part 在 Windows SharePoint Services 用户界面中显示的标题。

Description                        希望 Web Part 在 Windows SharePoint Services 用户界面中显示的描述信息。
ImportErrorMessage      如果 Windows SharePoint Services 不能成功导入 Web Part 解决方案显示出的错误信息。
自定义Web Part solution feature package

1 ．在解决方案浏览器中，右键单击 Web Part 项目，选择属性。
2 ．在属性窗口中，选择 SharePoint Solution 。
这个标签中将列出扩展将会生成的包含在解决方案包中的属性节点。
3 ．站看 Solution 节点，然后展开 Feature 节点和 Element 节点。
4 ．编辑一个节点的属性，点击选中一个节点，编辑想要修改的属性。
         例如：点击 Element 节点，然后编辑 Title ， Description 和 ImportErrorMessage 关键字的属性。
5 ．提交对于这个节点的修改，保存即可。

 

部署和调试Web Part

你可以部署和调试你的 Web Part ，这只需要简单的按一下 F5 即可。
注意：
为了进行调试，你必须在 Windows SharePoint Services 安装上启用 ASP Debugging 。
当按下 F5 后，扩展将自动生成、部署、初始化调试 Web Part solution feature 。为了完成这些工作，扩展将自动完成以下动作：
l  生成 Web Part 组件
l  将 Web Part 解决方案打包成 Windows SharePoint Services Feature 。
l  如果这个 Web Part 解决方案以前部署过，扩展将取消以前版本的 Web Part 解决方案的 Feature 。
l  将 Web Part 组件安装到 GAC 中。
l  在 Windows SharePoint Services 部署并激活 Web Part 解决方案 Feature 。
l  将 Web Part 加入到 SafeControls 列表中。
l  调用 iisreset 命令重新启动 Microsoft Internet Information Services (IIS) 。
l  将调试附加到 w3wp 进程上。
部署和调试 Web Part
1 ．按 F5 。扩展将自动生成、部署、初始化 Web Part 解决方案 Feature 调试。
2 ．打开在 SharePoint 站点中想要添加 Web Part 的 Web 部件页面。
3 ．在 Web 部件页上点击网站操作，选择编辑页面。
4 ．在向要添加 Web Part 的 Web Part Zone 中添加 Web Part 。
5 ．在弹出的添加 Web 部件 页面中，在所有 Web 部件 部分中的杂项中找到我们的 Web Part ，单击确定。

 

结论

这篇文章描述了如何利用 Visual Studio 2005 extensions for Windows SharePoint Services 3.0 创建、部署和测试 Windows SharePoint Services 中的 Web Part 。

 

其他资源

Windows SharePoint Services 3.0 Tools: Visual Studio 2005 extensions
Microsoft Windows SharePoint Services Developer Center

 

原文地址： 使用Visual Studio 2005扩展创建Windows SharePoint Services 3.0 Web Part