DynamicsLoader component is used for bulk uploading a large number of records to Dynamics 365.

To start uploading data, create a DynamicsLoader component. Then you may tweak its BatchSize property. BatchSize property determines a maximal number of records in a batch. After this you need to specify columns to load data. You may do it either manually, using the Columns property, or you may use the CreateColumns method to retrieve table columns information from the table specified in the TableName property. Then call the Open method and use the SetValue method to set values for the row fields. To switch to the next row, call the NextRow method.

After you have finished loading data, call the Close method. This mthod sends the last batch to the server.

The following example demonstrates using the DynamicsLoader class.

    using (var connection = new DynamicsConnection("Server=https://your_company.crm4.dynamics.com;User [email protected];Password=A123456789;")) {
        connection.Open();

        DynamicsLoader loader = new DynamicsLoader("Contact", connection);
        loader.Columns.Add("LastName", DbType.String, 0, 0, 0);

        try {
            loader.Open();
            for (int i = 1; i <= 100; i++) {
                loader.SetValue("LastName", "Test " + i);
                loader.NextRow();
            }
            loader.Close();
        }
        catch (DynamicsException ex) {

            // process exception
        }
    }

    Using connection As New DynamicsConnection("Server=https://your_company.crm4.dynamics.com;User [email protected];Password=A123456789;")
        connection.Open()

        Dim loader As New DynamicsLoader("Contact", connection)
        loader.Columns.Add("LastName", DbType.String, 0, 0, 0)

        Try
            loader.Open()
            For i As Integer = 1 To 100
                loader.SetValue("LastName", "Test " & i)
                loader.NextRow()
            Next
            loader.Close()

        Catch ex As DynamicsException
            'process exception

        End Try
    End Using

After calling the Close method you can retrieve the results of data loading operation as an array of structs with the GetResults method.