CRowset Class

Article
06/05/2017

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CRowset Class.

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

Syntax

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

Share via