COleDBRecordView Sınıfı

Denetimlerde veritabanı kayıtlarını görüntüleyen bir görünüm.

Sözdizimi

class COleDBRecordView : public CFormView

Üyeler

Korumalı Oluşturucular

Ad	Tanım
COleDBRecordView::COleDBRecordView	Bir COleDBRecordView nesne oluşturur.

Genel Yöntemler

Ad	Tanım
COleDBRecordView::OnGetRowset	Standart bir HRESULT değeri döndürür.
COleDBRecordView::OnMove	Veri kaynağında geçerli kaydı (kirliyse) Güncelleştirmeler ve belirtilen kayda (sonraki, önceki, ilk veya son) geçer.

Açıklamalar

Görünüm, bir nesneye doğrudan bağlı bir CRowset form görünümüdür. Görünüm bir iletişim kutusu şablonu kaynağından oluşturulur ve iletişim kutusu şablonunun denetimlerinde nesnenin alanlarını CRowset görüntüler. nesnesi, COleDBRecordView formdaki denetimler ile satır kümesinin alanları arasında veri hareketini otomatikleştirmek için iletişim kutusu veri değişimini (DDX) ve yerleşik gezinti işlevselliğini CRowsetkullanır. COleDBRecordView ayrıca ilk, sonraki, önceki veya son kayda geçmek için varsayılan bir uygulama ve şu anda görünümde olan kaydı güncelleştirmek için bir arabirim sağlar.

Doğrudan veritabanı kayıt kümesinden veri almak ve bir iletişim kutusu denetiminde görüntülemek için ile COleDbRecordView DDX işlevlerini kullanabilirsiniz. ile COleDbRecordViewişlevleri (örneğinDDX_Text) değil DDX_Field* yöntemlerini (gibiDDX_FieldText) kullanmanız DDX_* gerekir. DDX_FieldTextile çalışmaz çünkü DDX_FieldText (için) veya CDaoRecordset* (içinCRecordViewCDaoRecordView) türünde CRecordset* ek bir bağımsız değişken COleDbRecordView alır.

Dekont

OLE DB Tüketici Şablonu sınıfları yerine Veri Erişim Nesneleri (DAO) sınıflarıyla çalışıyorsanız, bunun yerine CDaoRecordView sınıfını kullanın. Daha fazla bilgi için Genel Bakış: Veritabanı Programlama makalesine bakın.

COleDBRecordView kayıt görünümünün kullanıcı arabirimini güncelleştirebilmesi için kullanıcının satır kümesindeki konumunu izler. Kullanıcı satır kümesinin herhangi bir sonuna geçtiğinde, kayıt görünümü kullanıcı arabirimi nesnelerini (menü öğeleri veya araç çubuğu düğmeleri gibi) aynı yönde daha fazla ilerlemek için devre dışı bırakır.

Satır kümesi sınıfları hakkında daha fazla bilgi için OLE DB Tüketici Şablonlarını Kullanma makalesine bakın.

Devralma Hiyerarşisi

Cobject

Ccmdtarget

Cwnd

Cview

Cscrollview

Cformview

COleDBRecordView

Gereksinimler

Üst bilgi: afxoledb.h

COleDBRecordView::COleDBRecordView

Bir COleDBRecordView nesne oluşturur.

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

Parametreler

lpszTemplateName
bir iletişim kutusu şablonu kaynağının adı olan null olarak sonlandırılan bir dize içerir.

nIDTemplate
İletişim kutusu şablonu kaynağının kimlik numarasını içerir.

Açıklamalar

türünden COleDBRecordViewtüretilmiş bir nesne oluşturduğunuzda, görünüm nesnesini oluşturmak ve görünümün temel aldığı iletişim kutusu kaynağını tanımlamak için oluşturuculardan birini çağırın. Kaynağı ada göre (bir dizeyi oluşturucuya bağımsız değişken olarak geçir) veya kimliğine göre tanımlayabilirsiniz (bağımsız değişken olarak işaretsiz bir tamsayı geçirebilirsiniz).

Dekont

Türetilmiş sınıfınız kendi oluşturucusunu sağlamalıdır . Oluşturucuda, kaynak adı veya kimliği bağımsız değişken olarak olan oluşturucuyu COleDBRecordView::COleDBRecordViewçağırın.

COleDBRecordView::OnGetRowset

Kayıt görünümüyle ilişkilendirilmiş CRowset<> nesnesi için bir tanıtıcı döndürür.

virtual CRowset<>* OnGetRowset() = 0;

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

Satır kümesi nesnesi oluşturmak veya almak ve buna bir tanıtıcı döndürmek için bu üye işlevini geçersiz kılmanız gerekir. ClassWizard ile kayıt görünümü sınıfınızı bildirirseniz sihirbaz sizin için varsayılan bir geçersiz kılma yazar. ClassWizard'ın varsayılan uygulaması, varsa kayıt görünümünde depolanan satır kümesi tutamacını döndürür. Aksi takdirde, ClassWizard ile belirttiğiniz türde bir satır kümesi nesnesi oluşturur ve tabloyu açmak veya sorguyu çalıştırmak için üye işlevini çağırır Open ve sonra nesneye bir tanıtıcı döndürür.

Dekont

MFC 7.0'ın OnGetRowset önceki sürümlerine bir CRowsetişaretçi döndürdü. çağıran OnGetRowsetkodunuz varsa dönüş türünü CRowset<> şablonuna dönüştürmelisiniz.

Örnek

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();

Daha fazla bilgi ve örnek için Kayıt Görünümleri: Kayıt Görünümü Kullanma makalesine bakın.

COleDBRecordView::OnMove

Satır kümesinde farklı bir kayda geçer ve alanlarını kayıt görünümünün denetimlerinde görüntüler.

virtual BOOL OnMove(UINT nIDMoveCommand);

Parametreler

nIDMoveCommand
Aşağıdaki standart komut kimliği değerlerinden biri:

• ID_RECORD_FIRST — Kayıt kümesindeki ilk kayda gitme.

• ID_RECORD_LAST — Kayıt kümesindeki son kayda gitme.

• ID_RECORD_NEXT — Kayıt kümesindeki bir sonraki kayda gitme.

• ID_RECORD_PREV — Kayıt kümesindeki önceki kayda gitme.

İade Değeri

Taşıma başarılı olursa sıfır olmayan; aksi takdirde taşıma isteği reddedildiyse 0.

Açıklamalar

Varsayılan uygulama, kayıt görünümüyle ilişkili nesnenin CRowset uygun Move üye işlevini çağırır.

Varsayılan olarak, OnMove kullanıcı kayıt görünümünde değiştirdiyse veri kaynağındaki geçerli kaydı güncelleştirir.

Uygulama Sihirbazı, İlk Kayıt, Son Kayıt, Sonraki Kayıt ve Önceki Kayıt menü öğeleriyle bir menü kaynağı oluşturur. Yerleştirilebilir Araç Çubuğu seçeneğini seçerseniz, Uygulama Sihirbazı bu komutlara karşılık gelen düğmeleri içeren bir araç çubuğu da oluşturur.

Kayıt kümesindeki son kaydı geçerseniz, kayıt görünümü son kaydı görüntülemeye devam eder. İlk kaydı geriye doğru taşırsanız, kayıt görünümü ilk kaydı görüntülemeye devam eder.

Ayrıca bkz.

Hiyerarşi Grafiği