RdaBatchOption Enumeration

Specifies whether or not the rows associated with the Push should be batched together in a single transaction.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

public enum RdaBatchOption

Member nameDescription
BatchingOffIndicates that SQL Server Compact does not batch rows pushed to SQL Server. The server processes each row separately. This is the default setting.
BatchingOnIndicates that SQL Server Compact batches the rows pushed to SQL Server into a single transaction.

This property specifies whether SQL Server Compact should batch the changes being sent to the SQL Server table. The default setting, BatchingOff, specifies that insert, update, and delete changes are applied to the SQL Server table as individual transactions. In this case, each transaction is not dependent on another to succeed. BatchingOn specifies that all changes be sent as a single transaction. In this case, all changes must succeed for the transaction to be successful. If one change fails, the entire transaction fails and no changes are applied to the SQL Server table.

Both BatchingOn and BatchingOff return all errors to the error table, not just the first error that occurs. For example, if BatchingOn is specified and three out of five changes fail, no changes are applied and all three failures are stored in the error table. If BatchingOff is specified, the same three failures are stored in the error table, and the other two changes are applied to the SQL Server table. For more information about handling batch errors, see "Remote Data Access (RDA) Conflict Detection and Reporting" in the SQL Server Compact Books Online.