为 SharePoint 创建 Web 部件

使用浏览器，使用 Web 部件，用户可以直接修改 SharePoint 网站页面的内容、外观和行为。Web 部件是运行在调用 web 部件页的页中的一种特殊类型的服务器端控件：是在 sharepoint 站点上显示页。有关 SharePoint 的 web 部件的更多信息，请参见 生成块：Web 部件。

Visual Studio 提供了可用于创建和调试在 SharePoint 网站的 web 部件的模板。

在 Visual Studio 中创建 Web 部件

通过添加 Web 部件 项目中创建一个 web 部件添加到任何 SharePoint 项目。您可以使用沙盒解决方案或场解决方案中的**“Web 部件”**项。

使用设计器，如果要以可视方式设计 web 部件，请创建一个 可视 Web 部件 项目或将 可视 Web 部件 项添加到任何 SharePoint 项目。您只能使用场解决方案中的**“可视 Web 部件”**项。

Web 部件项

Web 部件 项提供了可用于设计 SharePoint 网站的一个 web 部件的文件。当您将一个 Web 部件 项目时，Visual Studio 在项目中创建一个文件夹中添加几个文件添加到文件夹。下表介绍每个文件。

有关更多信息，请参见如何：创建 SharePoint Web 部件。

可视 Web 部件项

可视 web 部件 是使用创建的可视 Web 开发人员设计器在 Visual Studio 中的 web 部件。有关如何使用此设计器的更多信息，请参见 Visual Studio 11 beta 为 web 内容映射。

从功能上来说，可视 web 部件与 web 部件不同。**“可视 Web 部件”项包括一个“Web 部件”项和一个“用户控件”**项。

可以通过拖动或复制从 Visual Studio 工具箱 控件的设计 web 部件的外观到用户控件的图面。有关更多信息，请参见如何：使用设计器创建 SharePoint Web 部件。

SharePoint 控件

Visual Studio 用于创建 SharePoint 页提供这些控件，如应用程序页。这些控件将出现在工具箱中 SharePoint 控件下。这些控件的功能命名 Microsoft.SharePoint.WebControls 空间派生，包含 ASP.NET 服务器控件在 SharePoint 站点中使用和列表页。

调试 Web 部件

您可以调试包含一个 web 部件的 SharePoint 项目可以象调试其他 Visual Studio 项目。当您启动 Visual Studio 调试器时，Visual Studio 将打开 SharePoint 站点。

若要开始调试代码，请将添加 web 部件添加到 SharePoint 的 web 部件页。

有关如何调试 SharePoint 项目的更多信息，请参见SharePoint 解决方案疑难解答。

可视 Web 部件限制

开始 Visual Studio，您可以添加可视 web 部件添加到沙盒 SharePoint 解决方案与场解决方案。但是，可视 web 部件具有以下限制：

• 可视 web 部件不支持可替换参数。有关更多信息，请参见可替换参数。

• 用户控件或可视 web 部件无法拖和放置或复制到可视 web 部件上。此操作会生成错误。

• 可视 web 部件不直接支持 SharePoint server 标记例如$SPUrl。有关更多信息，请参见中的“沙盒可视 Web 的标记限制在主题 SharePoint 解决方案疑难解答部件”。

• 可视 web 在沙盒解决方法获取偶尔拆分为多个错误，“沙盒代码执行请求拒绝，因为沙盒代码宿主服务太忙处理该请求”。有关此错误的更多信息，请参见中的 SharePoint 开发人员团队博客这篇文章。

• 服务器端 JavaScript 调试在 Visual Studio 不支持，但是，客户端 JavaScript 调试支持。

  尽管您可以将内联 JavaScript 给服务器端标记文件，调试不为断点支持添加到标记。若要调试 JavaScript，请对标记文件的外部 JavaScript 文件，然后将 JavaScript 文件中设置断点。

• 内联 ASP.NET 代码调试在生成的代码文件必须完成而不是在标记文件。

• 可视 web 部件不支持使用 <@ Assembly Src= 指令。

• SharePoint web 控件以及这些 ASP.NET 控件将 SharePoint 沙盒环境中不支持。如果不支持的控件在可视 web 部件使用在沙盒解决方案，则错误、“该类型或命名空间名称“Theme 不存在该命名空间" Microsoft.SharePoint.WebControls”显示。

有关沙盒解决方案的更多信息，请参见 沙盒解决方案与场解决方案之间的差异。

创建基于较旧样式的 SharePoint 的 Web 部件

您可以使用 Visual Studio 模板创建 SharePoint 的自定义 ASP.NET 2.0 web 部件。ASP.NET 2.0 web 部件构建在 ASP.NET web 部件基础结构之上是新项目的推荐类型。

使用基于较旧样式 SharePoint 的 web 部件，在极少数情况下，您可能需要创建 web 部件。可以使用 Visual Studio 创建 web 部件的这些类型，但是，Visual Studio 不提供专门用来帮助您创建自己的任何模板。

有关的更多信息，当您可能希望创建基于较旧样式 SharePoint 的 web 部件，请 Web 部件基础结构在 Windows SharePoint services 中参见。使用基于较旧样式 SharePoint 的 web 部件，有关如何创建 web 部件的更多信息，请 创建一个基本的 SharePoint Web 部件的演练参见。

相关主题