ExactTargetLoader component is used for bulk uploading a large number of records to ExactTarget.

To start uploading data, create a ExactTargetLoader 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 ExactTargetLoader class.

    using (var connection = new ExactTargetConnection("user=MyCompanyAdmin;password=mypassword;url=https://webservice.s7.exacttarget.com/Service.asmx;")) {
        connection.Open();

        ExactTargetLoader loader = new ExactTargetLoader("Email", connection);
        loader.Columns.Add("Name", DbType.String, 0, 0, 0);
        loader.Columns.Add("Subject", DbType.String, 0, 0, 0);

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

            // process exception
        }
    }

    Using connection As New ExactTargetConnection("user=MyCompanyAdmin;password=mypassword;url=https://webservice.s7.exacttarget.com/Service.asmx;")
        connection.Open()

        Dim loader As New ExactTargetLoader("Email", connection)
        loader.Columns.Add("Name", DbType.String, 0, 0, 0)
        loader.Columns.Add("Subject", DbType.String, 0, 0, 0)

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

        Catch ex As ExactTargetException
            '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.