本教程将引导您了解如何在Visual Studio .NET中创建和导入SharePoint Web部件,重点关注WebPart的概念及其在SharePoint站点中的应用。
WebPart是SharePoint站点WebPartPage的基础组件,由WebPart描述文件(.dwp)和WebPart程序集(.dll)构成。它们同时也是ASP.NET自定义控件,允许用户个性化和交互化地修改页面内容。
此WalkThrough主要涵盖以下内容:
1. 如何在Visual Studio .NET中“可视化”创建WebPart:
首先,我们需要在VS.NET中创建一个空的Web项目,并添加一个“Web用户控件”。在设计视图中,构建所需功能的UserControl,例如在UserControl上放置一个Calendar控件。为了使UserControl不依赖于Code-Behind文件(.ascx.cs),我们需要在(.ascx)文件头部的“<%@ Control %>”标签中移除"CodeBehind"和"Inherited"属性。
2. 创建一个WebPart:
- 下载并安装WebPartTemplates for VS.NET插件。
- 使用VS.NET创建一个“WebPartLibrary”项目,如“SampleWebPart”。这将自动生成一个继承自`Microsoft.SharePoint.WebPartPages.WebPart`的WebPart类,通常命名为“WebPart1”,并已经重写了`RenderWebPart()`方法。
- 在生成的WebPart1类中,声明一个变量来存储第一步创建的UserControl实例,例如`private System.Web.UI.Control _innerUserControl;`
- 重写`CreateChildControls()`方法,以便在WebPart中加载UserControl的实例。在该方法内,实例化并添加第一步创建的UserControl。
接下来,我们将深入探讨如何快速将WebPart导入到SharePoint站点:
1. 导入WebPart到SharePoint站点:
- 生成解决方案,确保WebPart项目成功编译并生成.dll文件。
- 将.dll文件复制到SharePoint服务器上的GAC(全局程序集缓存)或者Web应用程序的Bin目录。
- 创建一个WebPart描述文件(.dwp)以描述WebPart的元数据,包括标题、描述、类别等。此文件通常在WebPart类的代码文件中通过`using System.ComponentModel;`和`[ToolboxData("<{0}:WebPart1 runat=server></{0}:WebPart1>")]`等属性来生成。
- 将.dwp文件上传到SharePoint站点的/_layouts目录。
- 在SharePoint站点的页面编辑模式下,通过“添加Web部件”功能,找到并添加新导入的WebPart。
总结:
WebPart是构建SharePoint应用程序的核心组件,通过Visual Studio .NET可以方便地创建和自定义WebPart。这个过程涉及UserControl的创建、WebPart的实现以及导入到SharePoint站点的步骤。理解并熟练掌握这些步骤对于开发SharePoint解决方案至关重要,因为WebParts允许用户动态地定制和交互他们的工作环境,提高了平台的灵活性和用户体验。