Location:
D32DBMS.H
Link against: edbms.lib
class RDbView : public RDbRowSet;
Generates rowsets from an SQL query. The query is prepared and evaluated using the interface to this class, while the rowset is manipulated using the RDbRowset base class.
There are no special rules to consider when deriving from this class.
RDbRowSet
- An abstract base class that provides functionality which is shared between SQL view objects and Table objects
RDbView
- Generates rowsets from an SQL query
Defined in RDbView
:
Evaluate()
, Evaluate()
, EvaluateAll()
, Prepare()
, Prepare()
, Prepare()
, Unevaluated()
Inherited from RDbRowSet
:
AtBeginning()
,
AtEnd()
,
AtRow()
,
BeginningL()
,
Bookmark()
,
Cancel()
,
Close()
,
ColCount()
,
ColDef()
,
ColDes()
,
ColDes16()
,
ColDes8()
,
ColInt()
,
ColInt16()
,
ColInt32()
,
ColInt64()
,
ColInt8()
,
ColLength()
,
ColReal()
,
ColReal32()
,
ColReal64()
,
ColSetL()
,
ColSize()
,
ColTime()
,
ColType()
,
ColUint()
,
ColUint16()
,
ColUint32()
,
ColUint8()
,
CountL()
,
DeleteL()
,
EBackwards
,
EBeginning
,
EEnd
,
EEnsure
,
EFirst
,
EForwards
,
EInsertOnly
,
ELast
,
ENext
,
EPrevious
,
EQuick
,
EReadOnly
,
EUpdatable
,
EndL()
,
FindL()
,
FirstL()
,
GetL()
,
GotoL()
,
InsertCopyL()
,
InsertL()
,
IsColNull()
,
IsEmptyL()
,
LastL()
,
MatchL()
,
NextL()
,
PreviousL()
,
PutL()
,
Reset()
,
SetColL()
,
SetColNullL()
,
TAccess
,
TAccuracy
,
TDirection
,
TPosition
,
UpdateL()
,
iCursor
Capability: | Security policy note: | For a secure shared database, the caller must satisfy the read access policy for the table. |
IMPORT_C TInt Prepare(RDbDatabase &aDatabase, const TDbQuery &aQuery, TAccess anAccess=EUpdatable);
Prepares the view object for evaluating an SQL select-statement.
Following preparation, the rowset object can always provide schema information, but the view may first require evaluation to generate the rowset for navigation.
|
|
Capability: | Security policy note: | For a secure shared database, the caller must satisfy the read access policy for the table. |
IMPORT_C TInt Prepare(RDbDatabase &aDatabase, const TDbQuery &aQuery, const TDbWindow &aWindow);
Prepares the view object for evaluating an SQL select-statement and specifies the evaluation window shape for the rowset.
The function does not specify the access specification for the rowset updatable access is given.
Following preparation, the rowset object can always provide schema information, but the view may first require evaluation to generate the rowset for navigation.
|
|
Capability: | Security policy note: | For a secure shared database, the caller must satisfy the read access policy for the table. |
IMPORT_C TInt Prepare(RDbDatabase &aDatabase, const TDbQuery &aQuery, const TDbWindow &aWindow, TAccess anAccess);
Prepares the view object for evaluating an SQL select-statement, specifies the evaluation window shape for the rowset, and sets the access specification for the rowset.
Following preparation, the rowset object can always provide schema information, but the view may first require evaluation to generate the rowset for navigation.
|
|
IMPORT_C TInt EvaluateAll();
Use this function to fully evaluate the view. It is equivalent to:
while (Unevaluated()
) { Evaluate()
; }
|
IMPORT_C TInt Evaluate();
Performs a single step of the view evaluation, and returns when the step is complete. To completely evaluate a view in one
go, EvaluateAll()
should be used.
|
IMPORT_C void Evaluate(TRequestStatus &aStatus);
Performs a single step of the view evaluation, returning immediately and signalling when the step is complete.
This function is most effectively used when the view evaluation is carried out from an active object.
|
IMPORT_C TBool Unevaluated() const;
Tests whether any more evaluation can be done to a view.
|