COleDBRecordView-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Een weergave waarin databaserecords in besturingselementen worden weergegeven.

Syntaxis

class COleDBRecordView : public CFormView

Leden

Beveiligde constructors

Naam	Description
COleDBRecordView::COleDBRecordView	Maakt een COleDBRecordView object.

Openbare methoden

Naam	Description
COleDBRecordView::OnGetRowset	Retourneert een standaard HRESULT-waarde.
COleDBRecordView::OnMove	Hiermee werkt u de huidige record (indien vuil) voor de gegevensbron bij en gaat u vervolgens naar de opgegeven record (volgende, vorige, eerste of laatste).

Opmerkingen

De weergave is een formulierweergave die rechtstreeks is verbonden met een CRowset object. De weergave wordt gemaakt op basis van een dialoogvenstersjabloonresource en geeft de velden van het CRowset object weer in de besturingselementen van de dialoogvenstersjabloon. Het COleDBRecordView object maakt gebruik van dialoogvenstergegevensuitwisseling (DDX) en de ingebouwde navigatiefunctionaliteit CRowsetom het verplaatsen van gegevens tussen de besturingselementen op het formulier en de velden van de rijenset te automatiseren. COleDBRecordView biedt ook een standaard implementatie voor het verplaatsen naar de eerste, volgende, vorige of laatste record en een interface voor het bijwerken van de record die momenteel wordt weergegeven.

U kunt DDX-functies gebruiken om COleDbRecordView gegevens rechtstreeks uit de databaserecordset op te halen en weer te geven in een dialoogvenster. U moet de DDX_* methoden (zoals DDX_Text), niet de DDX_Field* functies (zoals DDX_FieldText) gebruiken met COleDbRecordView. DDX_FieldText werkt niet omdat COleDbRecordViewDDX_FieldText er een extra argument van het type CRecordset* (voor CRecordView) of CDaoRecordset* (voor CDaoRecordView) wordt gebruikt.

Opmerking

Als u werkt met de DAO-klassen (Data Access Objects) in plaats van de OLE DB Consumer Template-klassen, gebruikt u in plaats daarvan klasse CDaoRecordView . Zie het artikel Overzicht: Databaseprogrammering voor meer informatie.

COleDBRecordView houdt de positie van de gebruiker in de rijenset bij, zodat de recordweergave de gebruikersinterface kan bijwerken. Wanneer de gebruiker naar het einde van de rijenset gaat, worden in de recordweergave objecten van de gebruikersinterface , zoals menu-items of werkbalkknoppen, uitgeschakeld om verder in dezelfde richting te gaan.

Zie het artikel Ole DB Consumer Templates gebruiken voor meer informatie over rijsetklassen.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CView

CScrollView

CFormView

COleDBRecordView

Requirements

Koptekst: afxoledb.h

COleDBRecordView::COleDBRecordView

Maakt een COleDBRecordView object.

COleDBRecordView(LPCTSTR lpszTemplateName);
COleDBRecordView(UINT nIDTemplate);

Parameterwaarden

lpszTemplateName
Bevat een door null beëindigde tekenreeks die de naam is van een dialoogvenstersjabloonresource.

nIDTemplate
Bevat het id-nummer van een dialoogvenstersjabloonresource.

Opmerkingen

Wanneer u een object van een type maakt dat is afgeleid COleDBRecordViewvan, roept u een van de constructors aan om het weergaveobject te maken en de dialoogvensterresource te identificeren waarop de weergave is gebaseerd. U kunt de resource identificeren op naam (geef een tekenreeks door als het argument aan de constructor) of door de bijbehorende id (geef een niet-ondertekend geheel getal door als het argument).

Opmerking

Uw afgeleide klasse moet een eigen constructor leveren. Roep in de constructor de constructor aan COleDBRecordView::COleDBRecordView, met de resourcenaam of id als argument.

COleDBRecordView::OnGetRowset

Retourneert een ingang voor het CRowset-object<> dat is gekoppeld aan de recordweergave.

virtual CRowset<>* OnGetRowset() = 0;

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

U moet deze lidfunctie overschrijven om een rijsetobject te maken of te verkrijgen en er een ingang naar te retourneren. Als u de recordweergaveklasse declareert met ClassWizard, schrijft de wizard een standaardoverschrijving voor u. De standaard implementatie van ClassWizard retourneert de rijsetgreep die is opgeslagen in de recordweergave als deze bestaat. Als dat niet het probleem is, wordt er een rijsetobject samengesteld van het type dat u hebt opgegeven met ClassWizard en wordt de lidfunctie aangeroepen Open om de tabel te openen of de query uit te voeren en wordt vervolgens een ingang naar het object geretourneerd.

Opmerking

Vorige aan MFC 7.0, OnGetRowset retourneerde een aanwijzer naar CRowset. Als u code hebt die aanroept OnGetRowset, moet u het retourtype wijzigen in de ge templatiseerde klasse CRowset<>.

Example

CFrameWnd* pFrame = (CFrameWnd*)AfxGetMainWnd();
COleDBRecordView* pView = (COleDBRecordView*)pFrame->GetActiveView();

// CProductAccessor is a user-defined accessor class
CRowset<CAccessor<CProductAccessor>>* pRowSet =
(CRowset<CAccessor<CProductAccessor>>*)pView->OnGetRowset();

Zie het artikel Recordweergaven: Een recordweergave gebruiken voor meer informatie en voorbeelden.

COleDBRecordView::OnMove

Hiermee gaat u naar een andere record in de rijenset en geeft u de velden weer in de besturingselementen van de recordweergave.

virtual BOOL OnMove(UINT nIDMoveCommand);

Parameterwaarden

nIDMoveCommand
Een van de volgende standaardopdracht-id-waarden:

• ID_RECORD_FIRST — Naar de eerste record in de recordset gaan.

• ID_RECORD_LAST : naar de laatste record in de recordset gaan.

• ID_RECORD_NEXT : naar de volgende record in de recordset gaan.

• ID_RECORD_PREV : naar de vorige record in de recordset gaan.

Retourwaarde

Niet-nul als de verplaatsing is geslaagd; anders 0 als de verplaatsingsaanvraag is geweigerd.

Opmerkingen

De standaard implementatie roept de juiste Move lidfunctie aan van het CRowset object dat is gekoppeld aan de recordweergave.

De huidige record op de gegevensbron wordt standaard OnMove bijgewerkt als de gebruiker deze heeft gewijzigd in de recordweergave.

De wizard Toepassing maakt een menuresource met menu-items First Record, Last Record, Next Record en Previous Record. Als u de optie Dockable Toolbar selecteert, maakt de wizard Toepassing ook een werkbalk met knoppen die overeenkomen met deze opdrachten.

Als u voorbij de laatste record in de recordset navigeert, blijft de recordweergave de laatste record weergeven. Als u achteruitgaat naar de eerste record, blijft de recordweergave de eerste record weergeven.

Zie ook

Hiërarchiegrafiek