使用 ExecuteMultiple 提高批量数据加载的性能

您可以使用 ExecuteMultipleRequest 消息在 Microsoft Dynamics CRM Online 2016 Update 和 Microsoft Dynamics CRM 2016（本地） 中（尤其在 Internet 延迟可能是最大限制因素的 Microsoft Dynamics CRM Online 中）支持更高吞吐批量消息传递方案。ExecuteMultipleRequest 接受消息 Requests 的输入集合，按消息请求在输入集合中出现的顺序执行每个消息请求，还可以返回包含发生的每个消息的响应或错误的 Responses 的集合。

示例

// Get a reference to the organization service.
using (_serviceProxy = new OrganizationServiceProxy(serverConfig.OrganizationUri, serverConfig.HomeRealmUri,serverConfig.Credentials, serverConfig.DeviceCredentials))
{
    // Enable early-bound type support to add/update entity records required for this sample.
    _serviceProxy.EnableProxyTypes();
    
    #region Execute Multiple with Results
    // Create an ExecuteMultipleRequest object.
    requestWithResults = new ExecuteMultipleRequest()
    {
        // Assign settings that define execution behavior: continue on error, return responses. 
        Settings = new ExecuteMultipleSettings()
        {
            ContinueOnError = false,
            ReturnResponses = true
        },
        // Create an empty organization request collection.
        Requests = new OrganizationRequestCollection()
    };

    // Create several (local, in memory) entities in a collection. 
    EntityCollection input = GetCollectionOfEntitiesToCreate();

    // Add a CreateRequest for each entity to the request collection.
    foreach (var entity in input.Entities)
    {
        CreateRequest createRequest = new CreateRequest { Target = entity };
        requestWithResults.Requests.Add(createRequest);
    }

    // Execute all the requests in the request collection using a single web method call.
    ExecuteMultipleResponse responseWithResults =
        (ExecuteMultipleResponse)_serviceProxy.Execute(requestWithResults);

    // Display the results returned in the responses.
    foreach (var responseItem in responseWithResults.Responses)
    {
        // A valid response.
        if (responseItem.Response != null)
            DisplayResponse(requestWithResults.Requests[responseItem.RequestIndex], responseItem.Response);

        // An error has occurred.
        else if (responseItem.Fault != null)
            DisplayFault(requestWithResults.Requests[responseItem.RequestIndex], 
                responseItem.RequestIndex, responseItem.Fault);
    }

ExecuteMultipleRequest 的 Settings 参数适用于控制执行行为和返回结果的请求集合中的所有请求。我们更详细地看一下这些选项。

 

ExecuteMultipleSettings 成员	说明
ContinueOnError	当为 true 时，继续处理集合中的下一个请求，即使从集合中当前请求的处理中返回错误。当为 false 时，不要继续处理下一个请求。
ReturnResponses	当为 true 时，从处理的每个消息请求返回响应。当为 false 时，不返回响应。 如果设置为 true 且请求不返回一个响应，由于这是其设计，因此该请求的 ExecuteMultipleResponseItem 设置为 空。 不过，即使为 false，如果返回错误， Responses 程序集将不为空。如果返回错误，则每个已处理请求的集合中将有一个响应项返回错误，Fault 将设置为发生的实际错误。