interface XBatchExecution in module com::sun::star::sdbc::

(Global Index)

Syntax

interface XBatchExecution : com::sun::star::uno::XInterface ;

Description

is used for collecting and executing a set of SQL statements.

Method Summary

addBatch adds a SQL command to the current batch of commmands for the statement object.

clearBatch makes the set of commands in the current batch empty.

executeBatch submits a batch of commands to the database for execution.

Known Services Which Export this Interface

com::sun::star::sdbc::Statement

Method Details



addBatch

Syntax

void addBatch (
string sql )
raises ( com::sun::star::sdbc::SQLException );

Description

adds a SQL command to the current batch of commmands for the statement object.

Parameter sql

the SQL statement which should be appended to the batch.

Throws

SQLException if a database access error occurs.

clearBatch

Syntax

void clearBatch ();
raises ( com::sun::star::sdbc::SQLException );

Description

makes the set of commands in the current batch empty.

Throws

SQLException if a database access error occurs.

executeBatch

Syntax

sequence< long > executeBatch ();
raises ( com::sun::star::sdbc::SQLException );

Description

submits a batch of commands to the database for execution.

Returns

an array of update counts containing one element for each command in the batch. The array is ordered according to the order in which commands were inserted into the batch.

Throws

SQLException if a database access error occurs.
Top of Page