CRecordset sınıfı

Makale
02/26/2013

Veri kaynağından seçilen kayıt kümesini temsil eder.

class CRecordset : public CObject

Üyeler

Ortak Oluşturucusu

Ad	Description
CRecordset::CRecordset	Yapıları bir CRecordset nesnesi. Türetilmiş bir sınıf, bu çağrı bir kurucu sağlamanız gerekir.

Public yöntemler

Ad	Description
CRecordset::AddNew	Yeni bir kayıt eklemek için hazırlar. Call Update ve buna ek olarak tamamlamak için.
CRecordset::CanAppend	Yeni kayıtlar recordset eklenebilir, sıfır olmayan bir değer döndüren AddNew üye işlevi.
CRecordset::CanBookmark	Recordset yer imlerini destekliyorsa, sıfır olmayan bir değer döndürür.
CRecordset::Cancel	Zaman uyumsuz bir işlem ya da ikinci bir iş parçacığı işlemi iptal eder.
CRecordset::CancelUpdate	Verilecek tüm bekleyen güncelleştirmeleri iptal eder bir AddNew veya Edit işlem.
CRecordset::CanRestart	Sıfır olmayan bir değer döndürür Eğer Requery kayıt kümesinin sorguyu yeniden çalıştırmak için çağrılabilir.
CRecordset::CanScroll	Kayıtlar arasında gezinebilirsiniz, sıfır olmayan bir değer döndürür.
CRecordset::CanTransact	Veri kaynağı hareketleri destekliyorsa, sıfır olmayan bir değer döndürür.
CRecordset::CanUpdate	Recordset güncelleştirilebilirse sıfır olmayan bir değer döndürür (ekleyebilir, güncelleştirme veya kayıtları silme).
CRecordset::CheckRowsetError	Kayıt alma sırasında oluşturulan hataları işlemek için çağrıldı.
CRecordset::Close	Recordset ve odbc kapatır hstmt ile ilişkilendirilmiş.
CRecordset::Delete	Geçerli kayıt recordset'ten siler. Silme işleminden sonra başka bir kayda açıkça kaydırması gerekir.
CRecordset::DoBulkFieldExchange	BULK satır Recordset'e veri kaynağından veri alışverişi için çağrıldı. Toplu kayıt alan değiş tokuşu (Bulk rfx) olarak uygular.
CRecordset::DoFieldExchange	(Her iki yönde) karşılık gelen veri kaynağı kaydı recordset alanı veri üyeleri arasındaki veri alışverişi için çağrıldı. Implements alan değiş tokuşu (rfx) kaydı.
CRecordset::Edit	Geçerli kayıttaki değişiklikler için hazırlar. Call Update düzenlemeyi tamamlamak için.
CRecordset::FlushResultSet	Önceden tanımlanmış bir sorgu kullanılırken alınması için başka bir sonuç ise sıfır döndürür ayarlayın.
CRecordset::GetBookmark	Parameter nesnesi, bir kaydın yer işaretinin değerini atar.
CRecordset::GetDefaultConnect	Varsayılan bağlantı dizesi al olarak adlandırılır.
CRecordset::GetDefaultSQL	Yürütmek için varsayılan sql dizesi al olarak adlandırılır.
CRecordset::GetFieldValue	Bir recordset bir alanın değerini döndürür.
CRecordset::GetODBCFieldCount	Kayıt kümesindeki alanların sayısını döndürür.
CRecordset::GetODBCFieldInfo	Bir recordset içinde belirli türde alanlar hakkında bilgi verir.
CRecordset::GetRecordCount	Kayıt kümesindeki kayıtların sayısını döndürür.
CRecordset::GetRowsetSize	Tek getirme sırasında almak istediğiniz kayıtların sayısını verir.
CRecordset::GetRowsFetched	Getirme sırasında alınan satır sayısını döndürür.
CRecordset::GetRowStatus	Fetch sonra satırın durumu döndürür.
CRecordset::GetSQL	Recordset kayıtları seçmek için kullanılan sql dizesini alır.
CRecordset::GetStatus	Recordset'in durumunu alır: dizin, geçerli kaydı ve kayıtların son sayısını mı başardı.
CRecordset::GetTableName	Recordset'i temel alan tablonun adını alır.
CRecordset::IsBOF	Recordset'in ilk kayıttan önce konumlandırdıysanız sıfır olmayan bir değer döndürür. Geçerli bir kayıt yoktur.
CRecordset::IsDeleted	Silinmiş bir kayıt Recordset'i konumlandırdıysanız sıfır olmayan bir değer döndürür.
CRecordset::IsEOF	Recordset'in son kayıtın arkasında konumlandırdıysanız sıfır olmayan bir değer döndürür. Geçerli bir kayıt yoktur.
CRecordset::IsFieldDirty	Geçerli kaydın belirtilen alanda değiştirdiyseniz, sıfır olmayan bir değer döndürür.
CRecordset::IsFieldNull	Geçerli kaydın belirtilen alanda null ise, sıfır olmayan bir değer döndürür (değersiz).
CRecordset::IsFieldNullable	Geçerli kaydın belirtilen alanda null (hiçbir değere sahip) olarak ayarlarsanız, sıfır olmayan bir değer döndürür.
CRecordset::IsOpen	Sıfır olmayan bir değer döndürür Eğer Open daha önce olarak adlandırılır.
CRecordset::Move	Recordset, geçerli kaydın her iki yönde belirlenen sayıda kayıt konumlandırır.
CRecordset::MoveFirst	Geçerli kayıt, kayıt kümesindeki ilk kaydı üzerinde konumlandırır. Test etmek için IsBOF ilk.
CRecordset::MoveLast	Geçerli kaydın son satır kümesi veya son kaydın üzerinde konumlandırır. Test etmek için IsEOF ilk.
CRecordset::MoveNext	Geçerli kaydın sonraki kaydı veya sonraki satır kümesi üzerinde konumlandırır. Test etmek için IsEOF ilk.
CRecordset::MovePrev	Bir önceki kayıttaki ya da önceki satır kümesi geçerli kayda konumlandırır. Test etmek için IsBOF ilk.
CRecordset::OnSetOptions	(Seçimde kullanılan) seçeneklerini ayarlamak için belirtilen odbc deyimi olarak adlandırılır.
CRecordset::OnSetUpdateOptions	Belirtilen odbc deyimi için (update sitesinde kullanılan) seçeneklerini ayarlama olarak bilinir.
CRecordset::Open	Tablo alma veya Recordset'i temsil eden sorgusu gerçekleştiren bir recordset açar.
CRecordset::RefreshRowset	Veri ve belirtilen satır durumu yeniler.
CRecordset::Requery	Seçili kayıtları yeniden yenilemek için kayıt kümesinin sorguyu çalıştırır.
CRecordset::SetAbsolutePosition	Belirtilen kayıt numarasına karşılık gelen kaydı Recordset'i konumlandırır.
CRecordset::SetBookmark	Recordset yer işareti tarafından belirtilen kayıt üzerinde konumlandırır.
CRecordset::SetFieldDirty	Geçerli kaydın belirtilen alanda değiştirilmiş olarak işaretlenir.
CRecordset::SetFieldNull	NULL (değer yok olması) geçerli kayıtta belirtilen alanın değerini ayarlar.
CRecordset::SetLockingMode	"İyimser" kilitleme (varsayılan) veya "kötümser" kilitleme kilitleme modu ayarlar. Kayıtların güncelleştirmeleri nasıl kilitlenmiş olduğunu belirler.
CRecordset::SetParamNull	Belirtilen parametre null (değer yok olması) ayarlar.
CRecordset::SetRowsetCursorPosition	Belirtilen satır satır kümesi içinde imleci konumlandırır.
CRecordset::SetRowsetSize	Getirme sırasında almak istediğiniz kayıt sayısını belirtir.
CRecordset::Update	Tamamlayan bir AddNew veya Edit yeni veya düzenlenmiş veriler veri kaynağı üzerinde kaydederek işlemi.

Ortak veri üyeleri

Ad	Description
CRecordset::m_hstmt	Recordset odbc deyimi tanıtıcı içerir. HSTMT yazın.
CRecordset::m_nFields	Kayıt kümesindeki alan veri üyeleri sayısını içerir. UINT yazın.
CRecordset::m_nParams	Parametre veri üyeleri recordset'teki sayısını içerir. UINT yazın.
CRecordset::m_pDatabase	Bir işaretçinin bulunduğu CDatabase limanının Recordset'in bağlı olduğu veri kaynağı nesnesi.
CRecordset::m_strFilter	İçeren bir CString belirleyen bir yapılandırılmış sorgu dili (sql) WHERE yan tümcesi. Yalnızca belirli ölçütlere uyan kayıtları seçmek için bir filtre olarak kullanılır.
CRecordset::m_strSort	İçeren bir CString belirleyen bir sql ORDER BY yan tümcesi. Kayıtların nasıl sıralandığını denetlemek için kullanılır.

Notlar

"Kayıt kümeleri," bilinen CRecordset nesneleri genelde iki biçimde kullanılır: dinamik kümelere ve anlık görüntüler. Dinamik küme diğer kullanıcıların yaptığı veri güncelleştirmeleri ile eşitlenmiş olarak kalan. Anlık görüntü verileri statik bir görünümüdür. Her form kayıt Recordset'in açılması zaman sabit bir kümesini temsil eder, ama dinamik küme içindeki bir kayıtla kaydırma yaptığınızda diğer kullanıcılar veya diğer kayıt kümeleri uygulamanızdaki kayda sonradan yapılan değişiklikleri yansıtır.

Not

Açık veritabanı bağlantısı (odbc) sınıfları yerine veri erişim nesneleri (dao) sınıfları ile çalışıyorsanız, sınıfını kullanmak CDaoRecordset onun yerine.Makalede daha fazla bilgi için bkz: Genel Bakış: veritabanı programlama.

Her iki tür bir recordset ile çalışmak için genellikle bir uygulamaya özgü recordset sınıfından türeyen CRecordset. Bir veri kaynağından alınan kayıtları kayıt kümeleri seçin ve sonra şunları yapabilirsiniz:

Kayıtlar arasında ilerleyin.
Kayıtları güncelleştirmek ve kilitleme modu belirtin.
Kayıt kümesi veri kaynağı üzerinde kullanılabilir olanlardan seçtiğinde görüntülenecek kayıtları sınırlamak için filtre uygulayın.
Recordset'i sıralayın.
Recordset'in çalışma zamanına kadar bilinen değil bilgilerle kendi seçim özelleştirme stratejisinin.

Kendi sınıfını kullanmak için bir veritabanı açın ve bir işaretçi kurucuya geçirerek bir recordset nesnesi oluşturmak sizin CDatabase nesnesi. Kayıt kümesinin çağrısı açık belirleyebileceğiniz nesnesinin dinamik küme veya anlık görüntü olup üye işlevi. Arama açık veri kaynağından verileri seçer. Recordset nesnesini açtıktan sonra üye işlevleri ve veri üyeleri kayıtlar arasında dolaşın ve üzerlerinde çalışmak için kullanın. Güncellenebilir veya salt okunur olup işlemler kullanılabilir nesne dinamik küme veya anlık görüntü, olmasına göre değişir (açık veritabanı bağlantısı (odbc) veri kaynağına yeteneğini bağlıdır), ve bulk satır getiriliyor mi koymuştur. Değiştirilmiş veya bu yana eklenen kayıtları yenilemek için açık çağırmak, nesnenin çağrısı Requery üye işlevi. Nesnenin çağrısı Kapat üye işlev ve ile işiniz bittiğinde nesnesini yok eder.

Bir türetilmiş, CRecordset sınıfı, kayıt alan değiş tokuşu (rfx) veya toplu kayıt alan değiş tokuşu (Bulk rfx) okuma ve kayıt alanlarını güncelleştirerek desteklemek için kullanılır.

Makaleleri alan değiş tokuşu kayıt kümeleri ve kayıt hakkında daha fazla bilgi için bkz: Genel Bakış: veritabanı programlama, Kayıt kümesi (odbc), Recordset: getiriliyor kayıtları toplu (odbc), ve Kaydı alan Exchange (rfx). Kümelere ve anlık görüntüler bir odak için makalelere bakın kesit ve anlık.