Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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ırDBPROP_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