CRecordset::SetBookmark
Recordset'i belirtilen yer imi içeren kaydı üzerinde konumlandırır.
void SetBookmark(
const CDBVariant& varBookmark
);
Parametreler
- varBookmark
Başvuru bir CDBVariant belirli bir kayıt için yer işaretinin değeri içeren nesne.
Notlar
Yer işaretleri kayıt kümesinde destekleyip desteklemediğini belirlemek için arama CanBookmark.Yer imleri bunlar destekleniyorsa kullanılabilir hale getirmek için ayarlamalısınız CRecordset::useBookmarks seçeneğini dwOptions parametresi açık üye işlevi.
[!NOT]
Yer imleri desteklenmeyen veya kullanılamıyorsa, arama SetBookmark bir özel durumu oluşturuldu neden olur.Yer işaretleri yalnızca ileri kayıt kümeleri üzerinde desteklenmiyor.
Önce geçerli kayıt için yer almak için çağrı GetBookmark, yer işaretinin değerini kaydeder bir CDBVariant nesnesi.Çağırarak bu kaydı daha sonra dönebilirsiniz SetBookmark kaydedilen yer işaretinin değerini kullanarak.
[!NOT]
Belirli kayıt işlemleri yer imi Kalıcılık arama önce denetlemeniz gerekir SetBookmark.Örneğin, yer işareti ile almak GetBookmark ve sonra call Requery, yer imi artık geçerli olmayabilir.Call CDatabase::GetBookmarkPersistence , güvenle çağırabileceğiniz olup olmadığını denetlemek için SetBookmark.
Makaleler yer imleri ve kayıt gezinme hakkında daha fazla bilgi için bkz: Recordset: yer imleri ve mutlak Pozisyonlar (odbc) ve Recordset: kaydırma (odbc).
Özel Durumlar
Bu yöntem türü istisnalar atabilirsiniz CDBException * ve CMemoryException*.
Gereksinimler
Başlık: afxdb.h