如何:导出 ASP.NET Web 部件并将其导入 SharePoint Foundation 网站

上次修改时间: 2010年4月9日

适用范围: SharePoint Foundation 2010

可以通过以下方式在 Microsoft SharePoint Foundation 应用程序中重用 Microsoft ASP.NET Web 部件:导出这些部件以创建 .webpart 文件,这些文件是包含有关 Web 部件的属性值、状态数据和程序集或源文件详细信息的 XML 文件。由于导出功能在默认情况下不可用,因此必须对 Web 部件代码和配置设置进行一些修改。

创建 .webpart 文件后,可以将其导入任何 SharePoint Foundation 应用程序,并使用 SharePoint Foundation 外观显示 Web 部件。

导出 ASP.NET Web 部件

  1. 在 Web 部件代码中,设置 ExportMode 属性以允许导出属性。在下面的代码中,将值设置为 All,这样将允许导出敏感属性。

    this.ExportMode = WebPartExportMode.All;
    
  2. 修改 web.config 文件的 <system.web> 部分,如下所示:

    <system.web>
       <webparts  enableExport="true" />
    <sytem.web>          
    
  3. 从 Web 部件菜单,选择 Export 以创建可导入到 SharePoint Foundation 网站页面的 .webpart 文件。

导入 .webpart 文件

  1. 将 Web 部件的程序集放置到解决方案库、Bin 目录或全局程序集缓存中。

    如果将程序集放置到解决方案库中,则程序集必须打包为沙盒解决方案并且不具有完全信任权限。有关沙盒解决方案的详细信息,请参阅沙盒解决方案

    如果将程序集放置到全局程序集缓存中,则在默认情况下,必须对程序集进行强命名并使用完全信任代码权限运行此程序集。Web 部件对所有 Web 应用程序可用。

    如果将程序集放置到 Bin 目录中,则在执行 Web 部件时,您不具有完全信任代码权限。因为在默认情况下,针对 Bin 目录的权限非常低,所以可能必须为 Web 部件创建新的信任策略文件(推荐),或在 web.config 文件中提高信任级别(默认值为 WSS_Minimal)。有关创建 CAS 安全策略的信息,请参阅保护 SharePoint Foundation 中的 Web 部件

  2. 向 web.config 文件中的安全控件列表添加 Web 部件,例如:

    <SafeControl 
       Assembly="MyWebPart"
       Namespace="MyWebParts"
       TypeName="*" 
       Safe="True"
    />
    
  3. 导航到 Web 部件库。在服务器功能区中的"库工具"上下文组的"文档"选项卡上,单击"上载文档"按钮。

  4. 在"上载 Web 部件"对话框中,单击"浏览"并导航到在前面的过程中创建的 .webpart 文件。单击"确定"。您的 Web 部件显示在 Web 部件列表中。

  5. 导航到希望在其中显示您的 Web 部件的页面。单击服务器功能区中的"页面"选项卡上的"编辑"按钮,以将页面置于编辑模式。

  6. 在"编辑工具"上下文组中的"插入"选项卡上,单击"Web 部件"按钮。

  7. 在"类别"列表中,查找"Web 部件"类别并在列表中选择 Web 部件。单击"添加"。该 Web 部件将显示在该页面中,就像显示在 ASP.NET 页面中一样,只是这次它具有标准 SharePoint Foundation 部件版式。

请参阅

概念

保护 SharePoint Foundation 中的 Web 部件

升级 Web 部件

其他资源

Developing Web Parts in Windows SharePoint Services