Share via

Web 部件

  • 项目

指定在 SharePoint 网站中用来执行活动或显示信息的模块化组件。

实例

开发小组需要访问后端错误报告数据库，以显示 Microsoft Office SharePoint Server 2007 中动态更新的错误跟踪数据。他们开发了一个 Web 部件，该部件可在 Office SharePoint Server 2007 环境中的任何网站上安装和使用。

技术详细信息

Web 部件包括引用 Web 部件程序集的 XML 文件结构（.dwp 或 .webpart），还可以包含描述 Web 部件实例的其他元数据（例如属性的默认值）。Web 部件也可以包含支持资源，例如图形图像、ECMAScript（JScript、JavaScript）文件、级联样式表或者 HTML 或 ASPX 页。

有些 Web 部件可用作访问数据的其他 Web 部件的筛选器，有些 Web 部件可用于显示静态内容，而有些 Web 部件可以访问和显示来自其他 SharePoint 列表、数据库、Excel Services 或业务数据目录中的动态数据。

支持详细信息

Web 部件程序集可以安装在 Web 应用程序的 bin 目录或全局程序集缓存中，但不应安装在 _app_bin 目录中。

停用或删除 Web 部件可能非常困难，因为没有简单的内置方法可确定每个 Web 部件实例化的位置。在 Web 部件实例数量未知的情况下，最佳方案是调整 Web 部件类或程序集的 SafeControls 列表项使其不再安全，但会显示一条说明，指示应删除 Web 部件的所有实例。

<SafeControl Assembly="MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31e9ace121e9429f" Namespace="MyNamespace" TypeName="MyWebPart1" Safe="False" UnsafeErrorMessage="This Web Part has been disabled. Please check back later."/>

通常应由较新的 Web 部件代码来处理 Web 部件的升级，即将现有属性转换为新结构，或删除弃用的属性。这样可以允许 Web 部件的每个实例在下次调用时升级，而不是一次升级所有实例。