操作指南:部署项目任务列表定义

本演练演示如何使用 Visual Studio 2012 创建、自定义、调试和部署 SharePoint 列表来跟踪项目任务。

注释

以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。 这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。 有关详细信息,请参阅 个性化设置 IDE

先决条件

  • Microsoft Windows 和 SharePoint 支持的版本。

  • Visual Studio 2017 或 Azure DevOps Services。

创建 SharePoint 列表

创建 SharePoint 列表项目并将列表定义与任务相关联。

  1. 打开 “新建项目 ”对话框,展开 SharePoint 节点,然后选择 2010 节点。

  2. “模板 ”窗格中,选择 SharePoint 2010 项目 模板,将项目命名为 ProjectTaskList,然后选择“ 确定 ”按钮。

    此时会显示 SharePoint 自定义向导

  3. 指定用于调试的本地 SharePoint 网站,选择“ 部署为场解决方案 ”选项按钮,然后选择“ 完成 ”按钮。

  4. 打开项目的快捷菜单,然后选择“ 添加新>”。

  5. 在“ 模板 ”窗格中,选择 “列表 ”模板,然后选择“ 添加 ”按钮。

    此时会显示 SharePoint 自定义向导

  6. 要为列表显示什么名称? 框中,输入 项目任务列表

  7. 根据现有列表类型的选项按钮选择“创建不可自定义的列表”,然后在其列表中选择“任务”,然后选择“完成”按钮。

    列表、功能和包显示在 解决方案资源管理器中。

添加事件接收器

在任务列表中,可以添加自动设置任务的截止日期和说明的事件接收器。 以下过程将简单的事件处理程序作为事件接收器添加到列表实例。

  1. 打开项目节点的快捷菜单,选择 “添加”,然后选择“ 新建项”。

  2. 在 SharePoint 模板列表中,选择 事件接收器 模板,然后将其命名为 ProjectTaskListEventReceiver

    此时会显示 SharePoint 自定义向导

  3. 选择事件接收器设置页上,从你想要哪种类型的事件接收器列表中选择列表项事件作为事件接收器的类型。

  4. “事件源 ”列表中,选择“ 任务”。

  5. 在要处理的事件列表中,选中 已添加项旁边的复选框,然后选择“ 完成 ”按钮。

    使用名为 ProjectTaskListEventReceiver 的代码文件将新的事件接收器节点添加到项目中。

  6. 将代码添加到 ProjectTaskListEventReceiver 代码文件中的 ItemAdded 方法。 每次添加新任务时,都会向任务添加默认截止日期和说明。 默认截止日期为 2009 年 7 月 1 日。

     public override void ItemAdded(SPItemEventProperties properties)
    {
        base.ItemAdded(properties);
        SPWeb web = properties.OpenWeb();
        properties.ListItem["Due Date"] = "July 1, 2009";
        properties.ListItem["Description"] = "This is a critical task.";
        properties.ListItem.Update(); 
    }
    

自定义项目任务列表功能

创建 SharePoint 解决方案时,Visual Studio 会自动为默认项目项创建功能。 可以使用功能设计器自定义 SharePoint 网站的项目任务列表设置。

  1. 解决方案资源管理器中,展开 “功能”。

  2. 打开 Feature1 的快捷菜单,然后选择 “视图设计器”。

  3. “标题 ”框中,输入 项目任务列表功能

  4. “作用域” 列表中,选择 “Web”。

  5. “属性” 窗口中,输入 1.0.0.0 作为 Version 属性的值。

自定义项目任务列表包

创建 SharePoint 项目时,Visual Studio 会自动将包含默认项目项的功能添加到包中。 可以使用包设计器自定义 SharePoint 网站的项目任务列表设置。

  1. SolutionExplorer 中,打开 的快捷菜单,然后选择 “视图设计器”。

  2. “名称 ”框中,输入 ProjectTaskListPackage

  3. 选中 “重置 Web 服务器 ”复选框。

生成和测试项目任务列表

运行项目时,SharePoint 网站将打开。 但是,必须手动导航到任务列表的位置。

  1. 选择要生成和部署项目任务列表的 F5 密钥。

    SharePoint 网站随即打开。

  2. 选择“ 开始 ”选项卡。

  3. 在左侧栏中,选择 “项目任务列表 ”链接。

    此时会显示“项目任务列表”页。

  4. “列表工具 ”选项卡中,选择“ ”选项卡。

  5. “项 ”组中,选择“ 新建项 ”按钮。

  6. “标题 ”文本框中,输入 Task1

  7. 选择“ 保存 ”按钮。

    刷新网站后, Task1 任务将显示截止日期为 2009 年 7 月 1 日。

  8. 选择 Task1

    此时会显示任务的详细视图,说明显示“这是关键任务”。

部署项目任务列表

生成并测试项目任务列表后,可以将其部署到 本地系统远程系统。 本地系统是开发解决方案的同一台计算机,而远程系统是另一台计算机。

将项目任务列表部署到本地系统

在 Visual Studio 菜单栏上,选择“ 生成>部署解决方案”。

Visual Studio 回收 IIS 应用程序池,收回解决方案的任何现有版本,将解决方案包 (.wsp) 文件复制到 SharePoint,然后激活其功能。 现在可以在 SharePoint 中使用解决方案。 有关部署配置步骤的详细信息,请参阅 如何:编辑 SharePoint 部署配置

将项目任务列表部署到远程系统

  1. 在 Visual Studio 菜单栏上,选择“ 生成>发布”。

  2. 在“ 发布 ”对话框中,选择“ 发布到文件系统 ”选项按钮。

    可以通过选择省略号按钮,然后导航到另一个位置来更改Ellipsis Icon“发布”对话框中的目标位置。

  3. 选择“ 发布 ”按钮。

    为解决方案创建 .wsp 文件。

  4. .wsp 文件复制到远程 SharePoint 系统。

  5. 使用 PowerShell Add-SPUserSolution 命令在远程 SharePoint 安装上安装包。 (对于农场解决方案,请使用 Add-SPSolution 命令。)

    例如,Add-SPUserSolution C:\MyProjects\ProjectTaskList\ProjectTaskList\bin\Debug\ProjectTaskList.wsp

  6. 使用 PowerShell Install-SPUserSolution 命令部署解决方案。 (对于场解决方案,请使用 Install-SPSolution 命令。

    例如,Install-SPUserSolution -Identity ProjectTaskList.wsp -Site http://NewSiteName

    有关远程部署的详细信息,请参阅在 SharePoint 2010 中使用解决方案和添加和部署解决方案