sanal void Taşı ( uzun nRows, kelime wFetchType = SQL_FETCH_RELATIVE);
atmak ( CDBException, CMemoryException );
Parametreleri
nRows
İleriye taşımak için satır sayısı veya geri. Pozitif değerler, kayıt kümesini sonuna doğru ilerlemek. Negatif değerler başına doğru geriye doğru gitme.
wFetchType
Hareket getirmek satır kümesi belirler. Ayrıntılı bilgi için açıklamalar bölümüne bakın.
Açıklamalar
İleriye ya da geriye dönük kayıt kümesi içinde geçerli kayıt işaretçisini taşımak için bu üye işlevini çağırın. NRowsiçin 0 değeri aktaryrsanyz, Move geçerli kaydı yeniler; Herhangi bir geçerli AddNew veya Edit modu sona erecek taşıyıp AddNew önce geçerli kaydın değerini geri yükler veya düzenleme çağrıldı.
&Notnbsp; Bir recordset geçerken, silinen kayıtların atlanabilir değil. IsDeleted üye işlev ayrıntıları için bkz.
Taşıma recordset satır kümeleri konumlandırır. Değerleri nRows ve wFetchTypebağlı olarak, uygun satır kümesi döndürür taşıyın ve ardından ilk kaydı bu satır kümesinde geçerli kayıt yapar. Sen toplu satır getiriliyor uygulamaya değil, satırkümesi boyutu 1 her zaman demektir. Satır kümesi alma zaman hareket doğrudan getirme kaynaklanan hataları işlemek için CheckRowsetError üye işlevini çağırır.
Geçmek değerlere bağlı, taşımak için diğer CRecordset üye işlevler eşdeğerdir. WFetchType değeri, daha sezgisel bir üye işlev ve genellikle geçerli kaydın taşınması için tercih edilen yöntem özellikle gösterebilir.
WFetchTypeiçin olası değerler aşağıdaki tabloda listelenmektedir, wFetchType , nRowsve wFetchType için karşılık gelen herhangi bir eşdeğer üye işlevi hareket getirmek satır kümesi tabanlı.
| wFetchType | Getirilen satır kümesi | Eşdeğer üye işlevi |
| SQL_FETCH_RELATIVE (varsayılan değer) | NRows satırları ilk satırı geçerli satır kümesi başlayarak satır kümesi. | |
| SQL_FETCH_NEXT SABİTİNİ | Sonraki satır kümesi; nRows yoksayılır. | MoveNext |
| SQL_FETCH_PRIOR | Önceki satır kümesi; nRows yoksayılır. | MovePrev |
| SQL_FETCH_FIRST | İlk satır kümesinde; nRows yoksayılır. | MoveFirst |
| SQL_FETCH_LAST | Son tam satır kümesinde; nRows yoksayılır. | MoveLast |
| SQL_FETCH_ABSOLUTE | Eğer nRows gt; 0, nRows satırları recordset başından başlayarak satır kümesi. NRows < 0 ' nRows başlayarak satır kümesi recordset sonundan row(s) eğer. If nRows = 0, dosya başına (bof) koşulu verilir. | SetAbsolutePosition |
| SQL_FETCH_BOOKMARK | Yer işaretinin değerini nRows için karşılık gelen satırda başlayan satır kümesi. | SetBookmark |
&Notnbsp; Salt ileri kayıt kümeleri için hareket yalnızca SQL_FETCH_NEXT sabitini bir değeri wFetchType için geçerlidir.
Dikkat Recordset kayıt varsa taşıma çağıran bir istisna atar. Recordset kayıt olup olmadığını belirlemek için IsBOF ve IsEOF arama.
Başında veya sonunda Recordset (IsBOF ya da IsEOF döner sıfır) kaydırdığınız, taşıma işlevini çağırarak muhtemelen bir CDBExceptionatmak olacaktır. Örneğin, IsEOF sıfır döndürür ve IsBOF yok, sonra MoveNext bir özel durum oluşturur, ancak MovePrev olmaz.
Geçerli kayıt olma sırasında Eğer arama hareket güncelleştirildi veya eklendi, güncelleştirmeler uyarı olmadan kaybolacaktır.
Kayıt gezinme hakkında daha fazla bilgi için bkz: makaleleri Recordset: kaydırma (odbc) ve Recordset: yer imleri ve mutlak pozisyonları (odbc) Visual c++ Programcı Kılavuzu. Satır toplu alma hakkında daha fazla bilgi için bkz: yazı Recordset: getiriliyor kayıtları toplu (odbc) Visual c++ Programcı Kılavuzu. İlgili bilgiler için bkz: odbc API işlevi SQLExtendedFetch odbc sdk Programcı Başvurusu.
Örnek
/ / rs bir CRecordset veya a / / CRecordset türetilen nesne
/ / 5 Satır kümesi boyutunu değiştirme
RS.SetRowsetSize (5);
/ / Taşımak için ilk kayıt
/ / Kayıt
RS.MoveFirst (;):
/ / Taşıma altıncı kayda
RS.(5) Gider;
/ / Eşdeğer diğer yolları
/ / altıncı kayda taşıdığınızda:
/ / rs.Taşıma (6, sql_fetch_absolute);
/ / rs.SetAbsolutePosition (6);
/ / Bu durumda altıncı kaydı
/ / bir sonraki satır, ilk kaydı
/ / Aşağıdaki de eşdeğer şekilde:
/ / rs.Taşı (1, SQL_FETCH_NEXT sabitini);
/ / rs.MoveNext)
CRecordset ge&nel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi
Ayrıca bkz:nbsp;CRecordset::Move&Next, CRecordset::MovePrev, CRecordset::MoveFirst, CRecordset::MoveLast, CRecordset::SetAbsolutePosition, CRecordset::SetBookmark, CRecordset::IsBOF, CRecordset::IsEOF, CRecordset::CheckRowsetError