sanal void AddNew ( );
atmak ( CDBException );
Açıklamalar
Tabloya yeni kayıt eklemek için hazırlamak için bu üye işlevini çağırın. Yeni eklenen kaydı görmeye Requery üye işlevi çağırmalıdır. Kayıttaki alanları başlangıçta boş. (Veritabanı terminolojisinde "hiçbir değere sahip" anlamına Null ve aynı boş c++ değildir.) İşlemi tamamlamak için güncelleştirme üye işlevi çağırmalıdır. Güncelleştirme değişiklikleri veri kaynağına kaydeder.
&Notnbsp; Satır toplu alma uyguladıysanız, AddNewçağrılamaz. Bu başarısız bir iddianın içinde sonuçlanır. Sınıf CRecordset toplu satır verileri güncelleştirmek için bir mekanizma sağlamaz, ancak SQLSetPosodbc API işlevini kullanarak kendi işlevlerinizi yazabilir. Bunu nasıl örneği için bkz: örnek dbfetch. Satır toplu alma hakkında daha fazla bilgi için bkz: yazı Recordset: getiriliyor kayıtları toplu (odbc) Visual c++ Programcı Kılavuzu.
Kayıt kümesinin alan veri üyeleri kullanarak yeni, boş bir kayıt AddNew hazırlar. AddNewçağırdıktan sonra kayıt kümesinin alan veri üyeleri istediğiniz değerleri ayarlayın. (Bu amaçla; düzenleme üye işlevini çağırın gerekmez düzenlemek için yalnızca varolan kayıtları kullanın.) Daha sonra Güncelleştirmeyiaradığınızda, üyeler veri kaynağında kaydedilen alan veri değerleri değiştirildi.
Dikkat Güncelleştirmearamadan önce yeni bir kayda ilerleyin, yeni kayıt kaybolur ve hiçbir uyarı verilir.
Veri kaynağı hareketleri destekliyorsa, bir hareketin parçası aramak, AddNew yapabilirsiniz. Hareketler hakkında daha fazla bilgi için bkz: sınıfın CDatabase. AddNew çağırmadan önce CDatabase::BeginTrans çağırmalısınız Not.
Ö&nemlinbsp; Kümelere için yeni kayıtlar son kaydı recordset'e eklenir. Kayıtları değil anlık görüntüler için added — recordset yenilemek için yeniden sorgulama çağırmanız gerekir.
Açık olan üye işlev çağrılmaz bir recordset için AddNew çağırmak geçersizdir. Önlerine cant bir kayıt kümesinin AddNew ararsanız bir CDBException oluşturuldu. CanAppend arayarak, kayıt kümesinin güncelleştirilebilir olup olmadığını belirleyebilirsiniz.
Daha fazla bilgi için Visual c++ Programcı Kılavuzu' nda aşağıdaki makalelere bakın: Recordset: nasıl kayıt kümeleri güncelleştirme kayıtları (odbc), Recordset: ekleme, güncelleştirme ve silme kayıtları (odbc), ve Hareket (odbc).
Örnek
Makaleye bakın hareketi: bir hareket bir Recordset (odbc) gerçekleştirme Visual c++ Programcı Kılavuzu.
CRecordset ge&nel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi
Ayrıca bkz: CRecordset::Edit, CRecordset::Delete, CRecordset::Update, CRecordset::Requery, CDatabase::BeginTrans, CDBException