Skip to content

crowset-class.md

Latest commit

 

History

History
99 lines (89 loc) · 4.81 KB

crowset-class.md

File metadata and controls

99 lines (89 loc) · 4.81 KB
title CRowset Class | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-windows
ms.tgt_pltfrm
ms.topic article
f1_keywords
ATL.CRowset<TAccessor>
CRowset
ATL::CRowset
ATL::CRowset<TAccessor>
ATL.CRowset
dev_langs
C++
helpviewer_keywords
CRowset class
ms.assetid b0228a90-b8dd-47cc-b397-8d4c15c1e7f4
caps.latest.revision 15
author mikeblome
ms.author mblome
manager ghogen
translation.priority.ht
cs-cz
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
pl-pl
pt-br
ru-ru
tr-tr
zh-cn
zh-tw

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

See Also

DBViewer Sample
MultiRead Sample
MultiRead Attributes Sample
OLE DB Consumer Templates
OLE DB Consumer Templates Reference