Power Apps 学习笔记 -- OrganizationRequestCollection

1. OrganizationRequestCollection 简介

  OrganizationRequestCollection 链接 : OrganizationRequestCollection

OrganizationRequestCollection 类:
public ref class OrganizationRequestCollection sealed : 
Microsoft::Xrm::Sdk::DataCollection<Microsoft::Xrm::Sdk::OrganizationRequest ^>

继承层次：Collection<T> -> DataCollection<OrganizationRequest> -> OrganizationRequestCollectionCollection提供了操作集合的基类，并且提供了基础的增删改查方法， DataCollection<> 继承了 Collection的
同时自己也提供了一些扩展方法， OrganizationRequest 是用于与数据库数据请求与交互的基类。OrganizationRequestCollection 综上可知，其是大批量事务执行的容器，可以用于储存多个基本的Organization
Request。常可以用于大批量的事务操作执行，提升与数据库的执行效率.

使用方法：基本单个的OrganizationRequest可以直接通过 IOrganizationService.Execute(OrganizationRequest) Method
可以通过 IOrganizationService直接执行即可对于OrganizationRequestCollection这个内部为多个请求所组成的数据请求集合，系统提供了继承Organization
Request的 ExecuteMultipleRequest 类，该类用于大批量的数据请求执行。

 

2. OrganizationRequestCollection

服务数据请求的基类 OrganizationRequest, 接下来逐个介绍常用的该基类的实现类，介绍其相关特性。

  OrganizationRequest 链接 : OrganizationRequest Class

2.1 OrganizationRequest 使用

CreateRequest

Guid guid = Guid.NewGuid();
Entity entity = new Entity("crda9_order");
entity["crda9_reason"] = "CreateReques 建立测试....";
entity.Id = guid;CreateRequest request = new CreateRequest(){Target = entity
};
OrganizationService.Execute(request);

UpdateRequest

Entity entity = new Entity("crda9_order");
entity["crda9_reason"] = "CreateReques 建立修改测试....";
entity.Id = new Guid("ba7cb4b9-8756-40de-9c73-18b6fa371bac");UpdateRequest request = new UpdateRequest(){Target = entity
};
OrganizationService.Execute(request);

RetrieveRequest

RetrieveRequest retrieveRequest = new RetrieveRequest() {ColumnSet = new ColumnSet(true),Target = new EntityReference("crda9_order", new Guid("ba7cb4b9-8756-40de-9c73-18b6fa371bac"))
};
var response = OrganizationService.Execute(retrieveRequest);

RetrieveRequest

DeleteRequest deleteRequest = new DeleteRequest() {Target = new EntityReference("crda9_order", new Guid("5a987003-7edf-ee11-904c-002248ed45e4"))
};
var response = OrganizationService.Execute(deleteRequest);

 

2.2 OrganizationRequestCollection 使用

修改类操作通常中间不会进行查询操作，因为是批量执行，无法在批量执行前获取查询的值再进行处理。

 Entity entity = new Entity("crda9_order") { Id = Guid.NewGuid() };entity["crda9_reason"] = "建立01..";CreateRequest createRequest = new CreateRequest() {Target = entity};orColl.Add(createRequest);entity = new Entity("crda9_order") { Id = new Guid("ba7cb4b9-8756-40de-9c73-18b6fa371bac") };entity["crda9_reason"] = "修改02...";UpdateRequest updateRequest = new UpdateRequest() { Target = entity};orColl.Add(updateRequest);ExecuteMultipleRequest emRequest = new ExecuteMultipleRequest() {Settings = new ExecuteMultipleSettings() {ContinueOnError = true,ReturnResponses = true},Requests = orColl};var response = OrganizationService.Execute(emRequest);