The SalSqlHandle type exposes the following members.

Methods

  NameDescription
Public methodClearContext
Clears the sql context.
Public methodCloseAllSPResultSets
Closes any result sets generated by the execution of a stored procedure.
Public methodCloseResultSet
Closes the result set.
Public methodCommit()()()()
Commits all of the SQL transaction's cursors that are connected to the same database.
Public methodCommit(WhenSqlErrorHandler)
Commits all of the SQL transaction's cursors that are connected to the same database.
Public methodConnect()()()()
Connects to a database. Uses Sql.Database, Sql.User and Sql.Password.
Public methodConnect(WhenSqlErrorHandler)
Connects to a database. Uses Sql.Database, Sql.User and Sql.Password.
Public methodConnect(String, String, String)
Connects to a database.
Public methodStatic memberDirectoryByName
Returns the database names on the specified server.
Public methodDisconnect()()()()
Disconnects from a database.
Public methodDisconnect(WhenSqlErrorHandler)
Disconnects from a database.
Public methodEquals
Overrides the Object.Equals() method.
(Overrides ValueType..::..Equals(Object).)
Public methodExecute()()()()
Executes a SQL statement that was prepared with SqlPrepare or retrieved with SqlRetrieve.
Public methodExecute(WhenSqlErrorHandler)
Executes a SQL statement that was prepared with SqlPrepare or retrieved with SqlRetrieve.
Public methodFetchNext()()()()
Fetches the next row in a result set.
Public methodFetchNext(SalNumber%)
Fetches the next row in a result set.
Public methodFetchNext(WhenSqlErrorHandler)
Fetches the next row in a result set.
Public methodFetchNext(SalNumber%, WhenSqlErrorHandler)
Fetches the next row in a result set.
Public methodFetchPrevious()()()()
Fetches the previous row in a result set.
Public methodFetchPrevious(SalNumber%)
Fetches the previous row in a result set.
Public methodFetchPrevious(WhenSqlErrorHandler)
Fetches the previous row in a result set.
Public methodFetchPrevious(SalNumber%, WhenSqlErrorHandler)
Fetches the previous row in a result set.
Public methodFetchRow(Int32)
Fetches a row according at the absolute row position.
Public methodFetchRow(Int32, SalNumber%)
Fetches a row according at the absolute row position.
Public methodFetchRow(Int32, WhenSqlErrorHandler)
Fetches a row according at the absolute row position.
Public methodFetchRow(Int32, SalNumber%, WhenSqlErrorHandler)
Fetches a row according at the absolute row position.
Public methodStatic memberFromHandle
Returns the SalSqlHandle object from the handle
Public methodGetContext
Returns the previously saved context for the sql handle.
Public methodGetError
Returns the last error information.
Public methodGetErrorPosition()()()()
Returns the offset of the error position within the last SQL statement.
Public methodGetErrorPosition(SalNumber%)
Returns the offset of the error position within the last SQL statement.
Public methodGetHashCode
Overrides the Object.GetHashCode() method
(Overrides ValueType..::..GetHashCode()()()().)
Public methodGetIsolationLevel
Returns the isolation level.
Public methodStatic memberGetLastStatement
Returns the last SQL statement used on this connection.
Public methodGetModifiedRows()()()()
Returns the number of rows affected by the most recent INSERT, UPDATE, or DELETE statement.
Public methodGetModifiedRows(SalNumber%)
Returns the number of rows affected by the most recent INSERT, UPDATE, or DELETE statement.
Public methodGetNextSPResultSet(String)
Returns the next result set returned by a stored procedure.
Public methodGetNextSPResultSet(String, SalBoolean%)
Returns the next result set returned by a stored procedure.
Public methodGetObjectData
Public methodGetParameter
Gets the value of a database parameter.
Public methodGetResultSetCount()()()()
Returns the number of rows in the result set.
Public methodGetResultSetCount(SalNumber%)
Returns the number of rows in the result set.
Public methodGetResultSetCount(WhenSqlErrorHandler)
Returns the number of rows in the result set.
Public methodGetResultSetCount(SalNumber%, WhenSqlErrorHandler)
Returns the number of rows in the result set.
Public methodGetSessionHandle()()()()
This call returns the session handle to which the specified statement handle belongs. The SqlHandle must have been created using SqlCreateStatement function and not by calling SqlConnect function.
Public methodGetSessionHandle(SalSqlSessionHandle%)
This call returns the session handle to which the specified statement handle belongs. The SqlHandle must have been created using SqlCreateStatement function and not by calling SqlConnect function.
Public methodGetStatementErrorInfo
Returns the error information associated with the specified statement handle (command/cursor).
Public methodMoveNext
Moves to the next row in the result set.
Public methodMovePrev
Moves to the previous row in the result set.
Public methodOraPLSQLCommand(SalString)
Executes an Oracle PL/SQL stored procedure. Supports dynamic arrays and recive array parameters.
Public methodOraPLSQLCommand(SalString, WhenSqlErrorHandler)
Executes an Oracle PL/SQL stored procedure. Supports dynamic arrays and recive array parameters.
Public methodOraPLSQLExecute()()()()
Executes the anonymous PL/SQL block that was prepared using SqlOraPLSQLPrepare.
Public methodOraPLSQLExecute(WhenSqlErrorHandler)
Executes the anonymous PL/SQL block that was prepared using SqlOraPLSQLPrepare.
Public methodOraPLSQLPrepare(SalString)
Compiles the anonymous PL/SQL block.
Public methodOraPLSQLPrepare(SalString, WhenSqlErrorHandler)
Compiles the anonymous PL/SQL block.
Public methodPrepare(String)
Compiles a SQL statement for execution.
Public methodPrepare(String, WhenSqlErrorHandler)
Compiles a SQL statement for execution.
Public methodPrepareAndExecute(String)
Compiles and executes a SQL statement.
Public methodPrepareAndExecute(String, WhenSqlErrorHandler)
Compiles and executes a SQL statement.
Public methodPrepareSP(String, String)
Prepares a stored procedure invokation statement.
Public methodPrepareSP(String, String, WhenSqlErrorHandler)
Prepares a stored procedure invokation statement.
Public methodRead
Returns an array with all the fields in the current row.
Public methodRetrieve(String, String, String)
Retrieves a SQLBase compiled command.

Remarks

This method is supposed to be used only with SQLBase. However, the PPJ Framework adapts the calling syntax to other databases as well.
Public methodRetrieve(String, String, String, WhenSqlErrorHandler)
Retrieves a SQLBase compiled command.
Public methodRollback()()()()
Executes a rollback on the current transaction.
Public methodRollback(WhenSqlErrorHandler)
Executes a rollback on the current transaction.
Public methodSetContext
Sets the context to be used to resolve bind expressions.
Public methodSetContextToForm()()()()
Sets the context to be used to resolve bind expressions.
Public methodSetContextToForm(Control)
Sets the context to be used to resolve bind expressions.
Public methodSetIsolationLevel
Sets the isolation level.
Public methodSetParameter
Sets the value of a database parameter.
Public methodSetResultSet
Enables result sets.
Public methodSetResultSetMode
Defines the behvaior for the ResultSet mode.
Public methodSetTimeout
Specifies the maximum time to wait before generating an error.
Public methodVarSetup
Saves the sql bind variables context.

Operators

  NameDescription
Public operatorStatic memberEquality(SalSqlHandle, SalWindowHandle)
== operator for comparing a SalSqlHandle to a SalWindowHandle
Public operatorStatic memberEquality(SalSqlHandle, SalSqlHandle)
== operator for comparing two SalSqlHandle objects
Public operatorStatic memberEquality(SalWindowHandle, SalSqlHandle)
== operator for comparing a SalSqlHandle to a SalWindowHandle
Public operatorStatic memberExplicitNarrowingExplicitExplicitExplicit(SalSqlHandle to SalWindowHandle)
Automatic casting from SalSqlHandle to SalWindowHandle.
Public operatorStatic memberExplicitNarrowingExplicitExplicitExplicit(SalWindowHandle to SalSqlHandle)
Automatic casting from int to SalSqlHandle.
Public operatorStatic memberImplicitWideningImplicitImplicitImplicit(SalSqlHandle to Boolean)
Automatic casting from SalSqlHandle to boolean
Public operatorStatic memberImplicitWideningImplicitImplicitImplicit(SalSqlHandle to SalBoolean)
Automatic casting from SalSqlHandle to SalBoolean
Public operatorStatic memberInequality(SalSqlHandle, SalWindowHandle)
!= operator for comparing a SalSqlHandle to a SalWindowHandle
Public operatorStatic memberInequality(SalSqlHandle, SalSqlHandle)
!= operator for comparing two SalSqlHandle objects
Public operatorStatic memberInequality(SalWindowHandle, SalSqlHandle)
!= operator for comparing a SalSqlHandle to a SalWindowHandle
Public operatorStatic memberLogicalNot
! boolean NOT operator

Fields

  NameDescription
Public fieldStatic memberNull

Properties

  NameDescription
Public propertyCommand
Returns the inner prepared command object.
Public propertyConnection
Returns the inner connection object.
Public propertyDataReader
Returns the underlying IDataReader object. It's null if ResultSet is on, use DataSet instead.
Public propertyDataSet
Returns the underlying DataSet object. It's null if ResultSet is off, use DataReader instead.
Public propertyHandle
Returns the handle for this SalSqlHandle object
Public propertyIsNull
Checks if this SalSqlHandle object contains a null db connection.
Public propertyLastError
Returns the last error occurred.
Public propertyLastErrorCode
Returns the last error code.
Public propertyLastErrorMessage
Returns the last error message.
Public propertyLastErrorPosition
Returns the last error position.
Public propertyLastStatement
Returns the last sql statement executed on this handle.
Public propertyProperties
Returns the properties associated with the connection.
Public propertyTransaction
Returns the current open transaction.

See Also