CRowset Class

Encapsulates an OLE DB rowset object and several related interfaces and provides manipulation methods for rowset data.

template <class TAccessor = CAccessorBase>
class CRowset

Parameters

  • TAccessor
    An accessor class. The default is CAccessorBase.

Members

Methods

AddRefRows

Increments the reference count associated with the current row.

Close

Releases rows and the current IRowset interface.

Compare

Compares two bookmarks using IRowsetLocate::Compare.

CRowset

Creates a new CRowset object and (optionally) associates it with an IRowset interface supplied as a parameter.

Delete

Deletes rows from the rowset using IRowsetChange:DeleteRows.

FindNextRow

Finds the next matching row after the specified bookmark.

GetApproximatePosition

Returns the approximate position of a row corresponding to a bookmark.

GetData

Retrieves data from the rowset's copy of the row.

GetDataHere

Retrieves data from the specified buffer.

GetOriginalData

Retrieves the data most recently fetched from or transmitted to the data source, ignoring pending changes.

GetRowStatus

Returns the status of all rows.

Insert

Creates and inserts a new row using IRowsetChange:InsertRow.

IsSameRow

Compares the specified row with the current row.

MoveFirst

Repositions the next-fetch location to the initial position.

MoveLast

Moves to the last record.

MoveNext

Fetches data from the next sequential row or a specified number of positions beyond the next row.

MovePrev

Moves to the previous record.

MoveToBookmark

Fetches the row marked by a bookmark or the row at a specified offset from that bookmark.

MoveToRatio

Fetches rows starting from a fractional position in the rowset.

ReleaseRows

Calls IRowset::ReleaseRows to release the current row handle.

SetData

Sets data values in one or more columns of a row using IRowsetChange:SetData.

Undo

Undoes any changes made to a row since the last fetch or Update.

Update

Transmits any pending changes made to the current row since the last fetch or update.

UpdateAll

Transmits any pending changes made to all rows since the last fetch or update.

Remarks

In OLE DB, a rowset is the object through which a program sets and retrieves data.

This class is not meant to be instantiated but rather passed as a template parameter to CTable or CCommand (CRowset is the default).

Requirements

Header: atldbcli.h

See Also

Concepts

DBViewer Sample

MultiRead Sample

MultiRead Attributes Sample

OLE DB Consumer Templates (C++)

OLE DB Consumer Templates Reference