此示例演示如何使用单个 Web 服务方法调用执行多个组织消息请求,将 ExecuteMultipleRequest 作为参数传递。 减少必须通过网络传输的消息请求数会导致消息处理性能增加。
如何运行此示例
- 下载或克隆 Microsoft/PowerApps-Samples 存储库,以便拥有本地副本。
- (可选)编辑
dataverse/App.config文件以定义连接字符串,并指定要连接的Microsoft Dataverse实例。 - 在 Visual Studio 中打开示例解决方案,然后按 F5 运行示例。 在
dataverse/App.config中指定connection string后,运行的任何示例都将使用该连接信息。
如果未在 dataverse/App.config 文件中指定connection string,则每次运行示例时都会打开一个对话框,需要输入要连接到的 Dataverse 实例以及要使用的凭据的相关信息。 该对话框会缓存先前连接记录,以便您选择历史连接。
此存储库中的示例需要连接到 Dataverse 实例才能运行,其中包括对 dataverse/App.config 文件的链接引用。
此示例的用途
该 ExecuteMultipleRequest 消息旨在用于一种情况下,该消息包含执行一个或多个消息请求所需的数据,并将其作为单个批处理操作进行执行,并可选择性地返回结果集合。
此示例的工作原理
为模拟本示例功能所述场景,示例将执行以下操作:
设置
检查当前组织的版本。
演示
- 该方法
ExecuteMultipleRequest创建ExecuteMultipleRequest对象。 - 该方法
ExecutingMultipleSettings分配定义执行行为的设置:在错误时继续,返回响应。 - 该方法
OrganizationRequestCollection创建一个空的组织请求集合。 - 将为每个表添加
CreateRequest方法到请求集合。 - 该
GetCollectionOdEntitiesToUpdate类更新之前创建的表。
清理
显示用于删除 在安装程序中创建的记录的选项。 如果要检查示例创建的表和数据,则删除是可选的。 您也可手动删除记录以实现相同效果。