Aracılığıyla paylaş


CRowset Sınıfı

Bir OLE DB satır kümesi nesnesini ve çeşitli ilgili arabirimleri kapsüller ve satır kümesi verileri için işleme yöntemleri sağlar.

Sözdizimi

template <class TAccessor = CAccessorBase>
class CRowset

Parametreler

Danışman
Erişimci sınıfı. Varsayılan değer: CAccessorBase.

Gereksinimler

Üst bilgi: atldbcli.h

Üyeler

Yöntemler

Veri Akışı Adı Açıklama
AddRefRows Geçerli satırla ilişkili başvuru sayısını artırır.
Kapat Satırları ve geçerli IRowset arabirimi serbest bırakır.
Karşılaştırmak IRowsetLocate::Compare kullanarak iki yer işaretini karşılaştırır.
CRowset Seti Yeni CRowset bir nesne oluşturur ve (isteğe bağlı olarak) bunu parametre olarak sağlanan bir IRowset arabirimle ilişkilendirir.
Silmek IRowsetChange::D eleteRows kullanarak satır kümesinden satırları siler.
SonrakiSatırı Bul Belirtilen yer işaretinden sonraki eşleşen satırı bulur.
GetApproximatePosition Yer işaretine karşılık gelen satırın yaklaşık konumunu döndürür.
GetData (Veri Verileri) Satır kümesinin satır kopyasından veri alır.
GetDataHere Belirtilen arabellekten veri alır.
GetOriginalData (Özgün Veriler) Bekleyen değişiklikleri yoksayarak veri kaynağından en son getirilen veya veri kaynağına iletilen verileri alır.
GetRowStatus Tüm satırların durumunu döndürür.
Ekle IRowsetChange::InsertRow kullanarak yeni bir satır oluşturur ve ekler.
IsSameRow Belirtilen satırı geçerli satırla karşılaştırır.
Önce Hareket Et Sonraki getirme konumunu başlangıç konumuna yeniden konumlandırır.
Son Hareket Son kayda geçer.
Sonraki Taşı Sonraki sıralı satırdan veya bir sonraki satırın ötesinde belirtilen sayıda konumdan veri getirir.
TaşıÖnceki Önceki kayda geçer.
Yer İşaretine Taşı Bir yer işareti tarafından işaretlenen satırı veya bu yer işaretinden belirtilen uzaklıkta satırı getirir.
MoveToRatio (Orana Taşı) Satır kümesindeki kesirli konumdan başlayan satırları getirir.
Yayın Satırları Geçerli satır tutamacını serbest bırakmak için IRowset::ReleaseRows'ı çağırır.
Set Verileri IRowsetChange::SetData kullanarak bir satırın bir veya daha fazla sütunundaki veri değerlerini ayarlar.
Geri almak Son getirme veya Güncelleştirme'den sonra bir satırda yapılan değişiklikleri geri alır.
Güncelleştirme Son getirme veya güncelleştirmeden sonra geçerli satıra yapılan bekleyen değişiklikleri iletir.
Tümünü Güncelle Son getirme veya güncelleştirmeden bu yana tüm satırlara yapılan bekleyen değişiklikleri iletir.

Açıklamalar

OLE DB'de satır kümesi, bir programın verileri ayarlayıp aldığı nesnedir.

Bu sınıfın örneği oluşturulacak şekilde tasarlanmamıştır, bunun yerine veya CTable (CCommandvarsayılandır) için şablon parametresi CRowset olarak geçirilir.

CRowset::AddRefRows

Geçerli satır tutamacıyla ilişkili başvuru sayısını artırmak için IRowset::AddRefRows'ı çağırır.

Sözdizimi

HRESULT AddRefRows() throw();

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem geçerli satır tanıtıcısı için başvuru sayısını artırır. Sayıyı azaltması için ReleaseRows'u çağırın. Taşıma yöntemleri tarafından döndürülen satırların başvuru sayısı birdir.

CRowset::Kapat

Satırları ve geçerli IRowset arabirimini serbest bırakır.

Sözdizimi

void Close() throw();

Açıklamalar

Bu yöntem, şu anda satır kümesindeki tüm satırları serbest bırakır.

CRowset::Karşılaştırmak

IRowsetLocate::Compare kullanarak iki yer işaretini karşılaştırır.

Sözdizimi

HRESULT Compare(const CBookmarkBase& bookmark1,
   const CBookmarkBase& bookmark2,
   DBCOMPARE* pComparison) const throw();

Parametreler

Yer İşareti1
[in] Karşılaştıracak ilk yer işareti.

Yer İşareti2
[in] Karşılaştıracak ikinci yer işareti.

pKarşılaştırma
[out] Karşılaştırma sonucunun işaretçisi.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetLocategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetLocate önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

Tüketicilerde yer işaretlerini kullanma hakkında bilgi için bkz . Yer İşaretlerini Kullanma.

CRowset::CRowset

Yeni CRowset bir nesne oluşturur ve (isteğe bağlı olarak) bunu parametre olarak sağlanan bir IRowset arabirimiyle ilişkilendirir.

Sözdizimi

CRowset();

CRowset(IRowset* pRowset);

Parametreler

pRowset
[in] Bu sınıfla ilişkilendirilecek bir IRowset arabirim işaretçisi.

CRowset::D elete

Geçerli satırı satır kümesinden silmek için IRowsetChange::D eleteRows öğesini çağırır.

Sözdizimi

HRESULT Delete() const throw();

Dönüş Değeri

Standart bir HRESULT.

CRowset::FindNextRow

Belirtilen yer işaretinden sonraki eşleşen satırı bulur.

Sözdizimi

HRESULT FindNextRow(DBCOMPAREOP op,
   BYTE* pData,
   DBTYPE wType,
   DBLENGTH nLength,
   BYTE bPrecision,
   BYTE bScale,
   BOOL bSkipCurrent = TRUE,
   CBookmarkBase* pBookmark = NULL) throw();

Parametreler

Op
[in] Satır değerlerini karşılaştırırken kullanılacak işlem. Değerler için bkz . IRowsetFind::FindNextRow.

pData (Veri Verileri)
[in] Eşleştirilecek değerin işaretçisi.

wType (Türü)
[in] Arabelleğin değer bölümünün veri türünü gösterir. Tür göstergeleri hakkında bilgi için bkz. Windows SDK'sında OLE DB Programcı Başvurusu'ndaki Veri Türleri.

nUzunluk
[in] Veri değeri için ayrılan tüketici veri yapısının bayt cinsinden uzunluğu. Ayrıntılar için OLE DB Programcı Başvurusu'ndaki DBBINDING Yapıları'nın cbMaxLen açıklamasına bakın.

bHassasiyet
[in] Veri alırken kullanılan en yüksek duyarlık. Yalnızca wType DBTYPE_NUMERIC olduğunda kullanılır. Daha fazla bilgi için OLE DB Programcı Başvurusu'ndaki DBTYPE_NUMERIC veya DBTYPE_DECIMAL içeren dönüştürmeler bölümüne bakın.

bÖlçek
[in] Veri alırken kullanılan ölçek. Yalnızca wType DBTYPE_NUMERIC veya DBTYPE_DECIMAL ise kullanılır. Daha fazla bilgi için OLE DB Programcı Başvurusu'ndaki DBTYPE_NUMERIC veya DBTYPE_DECIMAL içeren dönüştürmeler bölümüne bakın.

bSkipCurrent
[in] Aramanın başlatıldığı yer işaretinden satır sayısı.

pBookmark (Yer İşareti)
[in] Aramanın başlatıldığı konumun yer işareti.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetFindgerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetFind önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

Tüketicilerde yer işaretlerini kullanma hakkında bilgi için bkz . Yer İşaretlerini Kullanma.

CRowset::GetApproximatePosition

Yer işaretine karşılık gelen satırın yaklaşık konumunu döndürür.

Sözdizimi

HRESULT GetApproximatePosition(const CBookmarkBase* pBookmark,
   DBCOUNTITEM* pPosition,
   DBCOUNTITEM* pcRows) throw();

Parametreler

pBookmark (Yer İşareti)
[in] Konumu bulunabilecek satırı tanımlayan yer işareti işaretçisi. Yalnızca satır sayısı gerekliyse NULL.

pPozisyon
[out] Satırın konumunu döndüren GetApproximatePosition konumun işaretçisi. Konum gerekli değilse NULL.

pcRows
[out] Toplam satır sayısını döndüren GetApproximatePosition konumun işaretçisi. Satır sayısı gerekli değilse NULL.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetScrollgerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetScroll önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

Tüketicilerde yer işaretlerini kullanma hakkında bilgi için bkz . Yer İşaretlerini Kullanma.

CRowset::GetData

Satır kümesinin satır kopyasından veri alır.

Sözdizimi

HRESULT GetData() throw();

HRESULT GetData(int nAccessor) throw();

Parametreler

nErişimci
[in] Verilere erişmek için kullanılacak erişimcinin (sıfır uzaklık) dizin numarası.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

BEGIN_ACCESSOR'da otomatik erişimci olmayan bir erişimci belirtirseniz, erişimci numarasını geçirerek verileri açıkça almak için bu yöntemi kullanın.

CRowset::GetDataHere

Geçerli satırdan verileri alır ve belirtilen arabelleğe yerleştirir.

Sözdizimi

HRESULT GetDataHere(int nAccessor,
   void* pBuffer) throw();

Parametreler

nErişimci
[in] Verilere erişmek için kullanılacak erişimcinin dizin numarası.

pBuffer
[out] Geçerli kaydın verilerinin yerleştirildiği arabellek.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu işlevin nasıl kullanılacağına ilişkin bir örnek için MultiRead örneğine bakın.

CRowset::GetOriginalData

En son veri kaynağından getirilen veya veri kaynağına iletilen verileri almak için çağrılar IRowsetUpdate::GetOriginalData .

Sözdizimi

HRESULT GetOriginalData() throw();

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, veri kaynağından en son getirilen veya veri kaynağına iletilen verileri alır; bekleyen değişikliklere göre değerleri almaz.

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetUpdategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetUpdate önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

CRowset::GetRowStatus

Tüm satırların durumunu döndürür.

Sözdizimi

HRESULT GetRowStatus(DBPENDINGSTATUS* pStatus) const throw();

Parametreler

pStatus (pDurum)
[out] Durum değerini döndüren GetRowStatus konumun işaretçisi. OLE DB Programcı Başvurusu'nda DBPENDINGSTATUS bölümüne bakın.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetUpdategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetUpdate önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

CRowset::Ekle

Erişimciden alınan verileri kullanarak yeni bir satır oluşturur ve başlatır.

Sözdizimi

HRESULT Insert(int nAccessor = 0,
   bool bGetHRow = false) throw();

Parametreler

nErişimci
[in] Verileri eklemek için kullanılacak erişimcinin sayısı.

bGetHRow
[in] Eklenen satırın tanıtıcısının alınıp alınmadığını gösterir.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetChangegerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetChange önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

Bir veya daha fazla sütun yazılabilir değilse ekleme işlemi başarısız olabilir. Bunu düzeltmek için imleç haritanızı değiştirin.

Örnek

Aşağıdaki örnekte, bir satır kümesi aracılığıyla veri kaynağına erişme ve ardından bu satır kümesinde bir tablo kullanarak dize ekleme işlemi gösterilmektedir.

İlk olarak, projenize Yeni ATL Nesnesi ekleyerek bir tablo sınıfı oluşturun. Örneğin, Çalışma Alanı bölmesinde projeye sağ tıklayın ve Yeni ATL Nesnesi'ni seçin. Veri Erişimi kategorisinden Tüketici'yi seçin. Tablo türünde bir tüketici nesnesi oluşturun. (Seçme Tablo doğrudan tablodan bir satır kümesi oluşturur; Command seçildiğinde sql komutu aracılığıyla bir satır kümesi oluşturulur.) Veri kaynağına erişebileceğiniz bir tablo belirterek bir veri kaynağı seçin. Tüketici nesnenizi CCustomerTable olarak çağırırsanız, ekleme kodunuzu aşağıdaki gibi uygularsınız:

// Access the rowset using the wizard-generated class, CCustomerTable
CCustomerTable rs;           // Your CTable-derived class

// Insert a customer
// Note that for fixed-length fields such as billing ID it isn't necessary
// to set the length
rs.m_BillingID = 5002;
rs.m_dwBillingIDStatus = DBSTATUS_S_OK;

_tcscpy_s(rs.m_ContactFirstName, sizeof(rs.m_ContactFirstName) / sizeof(TCHAR), 
   _T("Malcolm"));
rs.m_dwContactFirstNameLength = 7;
rs.m_dwContactFirstNameStatus = DBSTATUS_S_OK;

_tcscpy_s(rs.m_L_Name, sizeof(rs.m_L_Name) / sizeof(TCHAR), _T("Reynolds"));
rs.m_dwL_NameLength = 8;
rs.m_dwContactFirstNameStatus = DBSTATUS_S_OK;

rs.m_CustomerID = 2005;
rs.m_dwCustomerIDStatus = DBSTATUS_S_OK;

_tcscpy_s(rs.m_PostalCode, sizeof(rs.m_PostalCode) / sizeof(TCHAR), 
   _T("34213-4444"));
rs.m_dwPostalCodeLength = 10;
rs.m_dwPostalCodeStatus = DBSTATUS_S_OK;

HRESULT hr = rs.Insert();
if (FAILED(hr))
{
   ATLTRACE(_T("Insert failed: 0x%X\n"), hr);
}

CRowset::IsSameRow

Belirtilen satırı geçerli satırla karşılaştırır.

Sözdizimi

HRESULT IsSameRow(HROW hRow) const throw();

Parametreler

hRow (Satır Arası)
[in] Geçerli satırla karşılaştıracak satır tutamacı.

Dönüş Değeri

Standart bir HRESULT. S_OK satırların aynı olduğunu gösterir. Diğer değerler için Bkz. Windows SDK'sında OLE DB Programcı Başvurusu'ndaki IRowsetIndentity::IsSameRow.

CRowset::Önce Hareket Et

İmleci ilk konuma taşır ve ilk satırı alır.

Sözdizimi

HRESULT MoveFirst() throw();

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Sonraki getirme konumunu ilk konuma (satır kümesi oluşturulduğunda bir sonraki getirme konumu olan konum) yeniden konumlandırmak için IRowset::RestartPosition'ı çağırır ve ilk satırı alır.

CRowset::MoveLast

İmleci son satıra taşır.

Sözdizimi

HRESULT MoveLast() throw();

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Sonraki getirme konumunu son konuma yeniden konumlandırmak için IRowset::RestartPosition'ı çağırır ve son satırı alır.

Bu yöntem, satır kümesini içeren tablo veya komutu çağırmadan DBPROP_CANSCROLLBACKWARDS önce VARIANT_TRUE olarak ayarlamanızı Open gerektirir. (Daha iyi performans için VARIANT_TRUE olarak da ayarlayabilirsiniz DBPROP_QUICKRESTART .)

CRowset::MoveNext

İmleci sonraki kayda taşır.

Sözdizimi

HRESULT MoveNext() throw();

HRESULT MoveNext(LONG lSkip,
   bool bForward= true) throw();

Parametreler

lAtla
[in] Getirmeden önce atlanması gereken satır sayısı.

bİleri
[in] Bir sonraki kayda geçmek içintrue, geri gitmek için geçirinfalse.

Dönüş Değeri

Standart bir HRESULT. Satır kümesinin sonuna ulaşıldığında, DB_S_ENDOFROWSET döndürür.

Açıklamalar

Nesneden CRowset sonraki sıralı satırı getirir ve önceki konumu anımsar. İsteğe bağlı olarak, lSkip satırlarını atlamayı veya geriye doğru ilerlemeyi seçebilirsiniz.

Bu yöntem, satır kümesini içeren tablo veya komutu çağırmadan Open önce aşağıdaki özellikleri ayarlamanızı gerektirir:

  • DBPROP_CANSCROLLBACKWARDSlSkipVARIANT_TRUE olmalıdır

  • DBPROP_CANFETCHBACKWARDSbForward = false ise VARIANT_TRUE olmalıdır

Aksi takdirde (lSkip= 0 ve > = true ise) ek özellik ayarlamanız gerekmez.

CRowset::MovePrev

İmleci önceki kayda taşır.

Sözdizimi

HRESULT MovePrev() throw();

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, satır kümesini içeren tablo veya komutu çağırmadan DBPROP_CANFETCHBACKWARDS önce veya DBPROP_CANSCROLLBACKWARDS VARIANT_TRUE ayarlamanızı Open gerektirir.

CRowset::MoveToBookmark

Bir yer işareti tarafından işaretlenen satırı veya belirtilen bir uzaklıkta (lSkip) bu yer işaretinden satırı getirir.

Sözdizimi

HRESULT MoveToBookmark(const CBookmarkBase& bookmark,
   LONG lSkip = 0) throw();

Parametreler

yer işareti
[in] Veri getirmek istediğiniz konumu işaretleyen yer işareti.

lAtla
[in] Yer işaretinden hedef satıra kadar olan satır sayısı. lSkip sıfırsa, getirilen ilk satır yer işaretli satırdır. lSkip 1 ise, getirilen ilk satır yer işaretli satırdan sonraki satırdır. lSkip -1 ise, getirilen ilk satır yer işaretli satırdan önceki satırdır.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetLocategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır DBPROP_IRowsetLocate kümesini içeren tablo veya komutu çağırmadan DBPROP_CANFETCHBACKWARDS önce VARIANT_TRUE ve VARIANT_TRUE olarak da ayarlamanız Open gerekir.

Tüketicilerde yer işaretlerini kullanma hakkında bilgi için bkz . Yer İşaretlerini Kullanma.

CRowset::MoveToRatio

Satır kümesindeki kesirli konumdan başlayan satırları getirir.

Sözdizimi

HRESULT MoveToRatio(DBCOUNTITEM nNumerator,
   DBCOUNTITEM nDenominator,bool bForward = true) throw();

Parametreler

nNumara
[in] Verilerin getirildiği kesirli konumsal değeri belirlemek için kullanılan pay.

nPayda
[in] Verilerin getirildiği kesirli konumsal değeri belirlemek için kullanılan payda.

bİleri
[in] İleri mi yoksa geri mi taşınacaklarını gösterir. Varsayılan değer ileridir.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

MoveToRatio satırları kabaca aşağıdaki formüle göre getirir:

(nNumerator * RowsetSize ) / nDenominator

burada RowsetSize satır kümesi boyutudur ve satırlar halinde ölçülür. Bu formülün doğruluğu belirli sağlayıcıya bağlıdır. Ayrıntılar için bkz . IRowsetScroll::GetRowsAtRatio.

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetScrollgerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetScroll önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

CRowset::ReleaseRows

Geçerli satır tutamacını serbest bırakmak için IRowset::ReleaseRows'ı çağırır.

Sözdizimi

HRESULT ReleaseRows() throw();

Dönüş Değeri

Standart bir HRESULT.

CRowset::Set Verileri

Bir satırın bir veya daha fazla sütunundaki veri değerlerini ayarlar.

Sözdizimi

HRESULT SetData() const throw();

HRESULT SetData(int nAccessor) const throw();

Parametreler

nErişimci
[in] Verilere erişmek için kullanılacak erişimcinin sayısı.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

SetData Bağımsız değişken kabul eden formda, güncelleştirme için tüm erişimciler kullanılır. Genellikle bir satırdaki sütunlarda veri değerlerini ayarlamak için çağırırsınız SetData ve sonra bu değişiklikleri iletmek için Update'i çağırırsınız.

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetChangegerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetChange önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

Bir veya daha fazla sütun yazılabilir değilse ayar işlemi başarısız olabilir. Bunu düzeltmek için imleç haritanızı değiştirin.

CRowset::Geri Al

Son getirme veya Güncelleştirme'den sonra bir satırda yapılan değişiklikleri geri alır.

Sözdizimi

HRESULT Undo(DBCOUNTITEM* pcRows = NULL,
   HROW* phRow = NULL,
   DBROWSTATUS* pStatus = NULL) throw();

Parametreler

pcRows
[out] Gerekirse geri almayı denediği satır sayısını döndürdüğü Undo konumun işaretçisi.

phRow (İngilizce)
[out] Gerekirse geri almayı denediği tüm satırların tanıtıcı dizisini döndürdüğü Undo konuma yönelik bir işaretçi.

pStatus (pDurum)
[out] Satır durumu değerini döndüren Undo konumun işaretçisi. pStatus null olduğunda durum döndürülmüyor.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetUpdategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetUpdate önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

CRowset::Güncelleme

Son getirme veya Update çağrısından sonra geçerli satıra yapılan bekleyen değişiklikleri iletir.

Sözdizimi

HRESULT Update(DBCOUNTITEM* pcRows = NULL,
   HROW* phRow = NULL,
   DBROWSTATUS* pStatus = NULL) throw();

Parametreler

pcRows
[out] Gerekirse, güncelleştirmeye çalıştığı satır sayısını döndürdüğü Update konumun işaretçisi.

phRow (İngilizce)
[out] Güncelleştirmeye çalıştığı satırın tutamacını döndürdüğü Update konumun işaretçisi. phRow null olduğunda hiçbir tanıtıcı döndürülür.

pStatus (pDurum)
[out] Satır durumu değerini döndüren Update konumun işaretçisi. pStatus null olduğunda durum döndürülmüyor.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu satır en son getirildiğinden veya güncelleştirildiğinden (veya Update kullanarak) geçerli satıra yapılan bekleyen değişiklikleri iletir. Genellikle bir satırdaki sütunlarda veri değerleri ayarlamak için SetData'yı çağırırsınız

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetUpdategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetUpdate önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

CRowset::Tümünü Güncelle

Son getirme veya Update çağrısından sonra tüm satırlara yapılan bekleyen değişiklikleri iletir.

Sözdizimi

HRESULT UpdateAll(DBCOUNTITEM* pcRows = NULL,
   HROW** pphRow = NULL,
   DBROWSTATUS** ppStatus = NULL) throw();

Parametreler

pcRows
[out] Gerekirse, güncelleştirmeye çalıştığı satır sayısını döndürdüğü UpdateAll konumun işaretçisi.

pphRow (pphRow)
[out] Güncelleştirilmeye çalışılan satırın tutamacını döndüren UpdateAll bellek işaretçisi. pphRow null olduğunda hiçbir tanıtıcı döndürülür.

ppStatus
[out] Satır durumu değerini döndüren Update konumun işaretçisi. ppStatus null olduğunda durum döndürülür.

Açıklamalar

Bu satırlar en son Updategetirildiğinden veya güncelleştirildiğinden bu yana tüm satırlara yapılan bekleyen değişiklikleri iletir. UpdateAll , hala tanıtıcıya sahip olup olmadığınız fark etmeksizin değiştirilmiş olan her satırı güncelleştirir (bkz . pphRow).

Örneğin, satır kümesine beş satır eklediyseniz Insert , beş kez arayabilir Update veya tümünü güncelleştirmek için bir kez çağırabilirsiniz UpdateAll .

Bu yöntem, tüm sağlayıcılarda desteklenmeyen isteğe bağlı arabirimini IRowsetUpdategerektirir; bu durumda yöntem E_NOINTERFACE döndürür. Satır kümesini içeren tablo veya komutu çağırmadan DBPROP_IRowsetUpdate önce de VARIANT_TRUE olarak ayarlamanız Open gerekir.

Dönüş Değeri

Standart bir HRESULT.

Ayrıca bkz.

DBViewer Örneği
Çoklu okuma örneği
MultiRead Öznitelikleri Örneği
OLE DB Tüketici Şablonları
OLE DB Tüketici Şablonları Başvurusu