Freigeben über


CDaoRecordset::Move

Rufen Sie diese Memberfunktion auf, um die lRows-Datensätze des Recordsets aus dem aktuellen Datensatz zu positionieren.

virtual void Move(
   long lRows 
);

Parameter

  • lRows
    Die Anzahl von Datensätzen, um vorwärts oder rückwärts zu verschieben.Positive Werte verschieben vorwärts, gegen Ende des Recordsets.Negative Werte rückwärts verschieben, für den Start.

Hinweise

Sie können vorwärts oder rückwärts verschieben.Move( 1 ) ist zu MoveNext entsprechend, und Move( -1 ) ist zu MovePrev entsprechend.

WarnhinweisVorsicht

Eine der Move-Funktionen aufgerufen, löst eine Ausnahme aus, wenn das Recordset keine Datensätze verfügt.Im Allgemeinen rufen Sie IsBOF und IsEOF vor einem Verschiebungsvorgang auf, um zu bestimmen, ob das Recordset alle Datensätze verfügt.Nachdem Sie Öffnen oder Requery aufrufen, rufen Sie entweder IsBOF oder IsEOF auf.

HinweisHinweis

Wenn Sie über den Anfang oder Ende des Recordsets (IsBOF oder IsEOF gibt Wert ungleich 0 zurück), gescrollt haben, löst ein Aufruf MoveCDaoException aus.

HinweisHinweis

Wenn Sie aufrufen, wird entweder Move, während der aktuelle Datensatz aktualisiert oder hinzugefügt wird, die Updates verloren, ohne Warnung.

Wenn Sie Move auf einer vorwärts Bildlaufmomentaufnahme aufrufen, muss der lRows-Parameter eine positive ganze Zahl sein und Lesezeichen sind nicht zulässig, sodass Sie nur vorwärts verschieben.

Um die erste auszuführen, rufen letzten, nächsten oder vorherigen Datensatz in einem Recordset der aktuelle Datensatz, MoveFirst, MoveLast, MoveNext oder MovePrev-Memberfunktion auf.

Weitere Informationen finden Sie in den Themen "Verschiebungs-Methode" und "MoveFirst, MoveLast, MoveNext, MovePrevious-Methoden" in der DAO-Hilfe.

Anforderungen

Header: afxdao.h

Siehe auch

Referenz

CDaoRecordset-Klasse

Hierarchien-Diagramm

CDaoRecordset::MoveFirst

CDaoRecordset::MoveLast

CDaoRecordset::MoveNext

CDaoRecordset::MovePrev