SharePoint 加载项模型中的列表定义/列表模板
在新 SharePoint 外接程序模型中创建列表定义/列表模板的方法与使用完全信任代码不同。 在典型完全信任代码 (FTC)/场解决方案场景中,通过 SharePoint 解决方案,使用声明性代码创建了列表定义/列表模板并对其部署。
在 SharePoint 外接程序模型场景中实际上无法创建自定义列表定义。 不可能这样做。 但可以使用远程预配模式向 Office 365 部署自定义列表模板(.stp 文件)。
高级别准则
作为经验法则,我们希望提供以下有关实现列表定义/列表模板的高级别准则。
- 使用远程预配模式向 SharePoint 网站部署列表模板(.stp 文件)。
- 您可以替代现成的列表创建行为,以将标准化设置应用于在 SharePoint 网站中创建的所有列表。 有关此方法的详细信息,请参阅以下内容。
- 你可以创建 SharePoint 外接程序以使用标准设置创建列表。 有关此方法的详细信息,请参阅以下内容。
将确保标准化设置(模板)的方法应用于 SharePoint 列表(列表创建后)
有几种方法可以确保将标准化设置(模板)应用于 SharePoint 列表(列表创建后)。
- 替代现有的列表创建行为。
- 创建 SharePoint 外接程序。
替代现有的列表创建行为
在此模式中,可以通过向 ListAdded 事件添加事件接收器来修改现用的列表创建行为。 然后,在对 ListAdded 事件进行了配置的事件接收器中,使用远程预配模式将标准化配置应用到创建的每个列表。
这些标准化配置可包括添加内容类型、设置默认内容类型、添加列表列、设置版本设置以及可能被设置的任何其他列表类型配置。
- 此方法允许你对所有列表应用标准化设置。
- 此方法允许你对不同类型的列表应用标准化设置。
- 例如:如果创建文档库和任务列表,你可以在 ListAdded 事件接收器中确定你创建列表的类型,并可基于列表类型应用不同的标准化设置。 也许所有文档库都需要应用于它们的一组内容类型,而所有任务列表都需要应用于它们的不同组的内容类型。
- 此方法不支持向列表应用多个不同的模板选项。
- 例如:如果创建文档库和任务列表,你可以在 ListAdded 事件接收器中确定你创建列表的类型,并可基于列表类型应用不同的标准化设置。 但不能向你相对于你所创建的另一个文档库创建的一个文档库应用不同的模板。
何时适合?
当你需要向所有列表或特定类型的列表应用标准化的全局设置时。
何时不适合?
当你需要向列表应用多个不同的模板时。
开始使用
以下 SharePoint 外接程序模型方法介绍了如何实现事件接收器。
创建 SharePoint 外接程序
在此模式中,创建 SharePoint 外接程序以使用标准化设置创建列表,并指导用户使用 SharePoint 外接程序来创建新列表。 实质上,SharePoint 外接程序为用户提供了创建不同列表的选择。 SharePoint 外接程序允许用户创建的不同列表由企业定义,并由开发人员实施。 用户在 SharePoint 外接程序中填写表单以指定列表元数据,并从外接程序提供的选项中选择创建那个列表。 外接程序使用远程预配模式以创建相应的列表。
- 此方法允许你对所有列表应用标准化设置。
- 此方法允许你对不同类型的列表应用标准化设置。
- 此方法允许你向列表应用多个不同的模板。
何时适合?
当你需要向列表应用多个不同的模板时。
开始使用
以下 O365 PnP 代码示例和视频演示了如何创建 SharePoint 外接程序(该外接程序提供了用户界面,使最终用户能够创建新的文档库)。 它还演示了如何使用特定配置(统一代表一个模板)创建文档库。
以下视频将展示整个代码示例。
相关链接
- 列表实例(SharePoint 外接程序模型方法)
- 事件接收器(SharePoint 外接程序方法)
- 使用应用模型的文档和列表模板(O365 PnP 视频)
- 指南文章中 https://aka.ms/OfficeDevPnPGuidance
- MSDN 中的引用位于 https://aka.ms/OfficeDevPnPMSDN
- 视频中的 https://aka.ms/OfficeDevPnPVideos
PnP 示例
适用于
- Office 365 多租户 (MT)
- Office 365 专用 (D) 部分
- SharePoint 2013 本地 – 部分
专用模式和本地模式在使用 SharePoint 外接程序模型技术方面完全相同,但在可以使用的可能的技术方面存在差异。