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

(Global Index)

Syntax

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

Description

provides the possibilty of executing a precompiled SQL statement.

A SQL statement is pre-compiled and stored in a PreparedStatement object. This object can then be used to efficiently execute this statement multiple times.

Method Summary

executeQuery executes the SQL query in this PreparedStatement object and returns the result set generated by the query.

executeUpdate executes the SQL INSERT, UPDATE or DELETE statement in this PreparedStatement object.
In addition, SQL statements that return nothing, such as SQL DDL statements, can be executed.

execute executes any kind of SQL statement.

getConnection returns the Connection object that produced this Statement object.

Known Services Which Export this Interface

com::sun::star::sdbc::PreparedStatement

Method Details



executeQuery

Syntax

com::sun::star::sdbc::XResultSet executeQuery ();
raises ( com::sun::star::sdbc::SQLException );

Description

executes the SQL query in this PreparedStatement object and returns the result set generated by the query.

Returns

the ResultSet object

Throws

SQLException if a database access error occurs.

executeUpdate

Syntax

long executeUpdate ();
raises ( com::sun::star::sdbc::SQLException );

Description

executes the SQL INSERT, UPDATE or DELETE statement in this PreparedStatement object.
In addition, SQL statements that return nothing, such as SQL DDL statements, can be executed.

Returns

either the row count for INSERT, UPDATE or DELETE statements; or 0 for SQL statements that return nothing

Throws

SQLException if a database access error occurs.

execute

Syntax

boolean execute ();
raises ( com::sun::star::sdbc::SQLException );

Description

executes any kind of SQL statement.

Some prepared statements return multiple results; the execute method handles these complex statements as well as the simpler form of statements handled by executeQuery and executeUpdate.

Returns

true if successful

Throws

SQLException if a database access error occurs.

getConnection

Syntax

com::sun::star::sdbc::XConnection getConnection ();
raises ( com::sun::star::sdbc::SQLException );

Description

returns the Connection object that produced this Statement object.

Returns

the Connection object

Throws

SQLException if a database access error occurs.
Top of Page