Satırları getiriliyor
IRowset temel satır kümesi arabirim bir arabirimdir. IRowset arabirimi ardışık satırlar getiriliyor, veri alma-bu satırları ve satır yönetme yöntemleri sağlar. Tüketicilerin kullanma yöntemleri IRowset tüm temel satır kümesi işlemleri için. Bu getiriliyor ve serbest satır ve sütun değerlerini elde içerir.
Tüketici bir arabirim işaretçisi bir satır kümesi aldığında ilk adım normalde kullanarak satır kümesi özelliklerini belirlemek için ise IRowsetInfo::GetProperties yöntemi. Bu satır kümesi ve ayrıca etkin satır sayısını ve bekleyen güncelleştirmeler aynı anda olabilir satır sayısı gibi farklı arabirimleri olarak görünmüyor yetenekleri satır kümesi tarafından maruz arabirimleri hakkında bilgi verir.
Tüketiciler için bir sonraki adım, özellikleri veya meta verileri, satır kümesi sütunlar belirlemektir. Bunun için kullandıkları IColumnsInfo yöntemi için basit sütun bilgileri veya IColumnsRowset yöntemi için genişletilmiş sütun bilgileri. PipelineBufferGetColumnInfo yöntemi aşağıdaki bilgileri verir:
Sonuç kümesinde sütun sayısı.
DBCOLUMNINFO yapıları, her sütun bir dizi.
Sütunları kümesi içinde göründükleri sırayı yapıları sırasıdır. Her DBCOLUMNINFO yapısı sütun adı, sütun, a sütunundaki değeri, veri türü, uzunluk, duyarlık ve sütun olası uzunluğu en fazla sıralı sütun meta verileri içerir.
Tüm dize değerleri içinde bir tek ayırma bloğu için bir depolama için işaretçi.
Tüketici meta ya da ihtiyacı veya satır kümesi oluşturan metin komutu temel alan sütunları belirler. Tarafından döndürülen sütun bilgileri sipariş sayfasından gerekli sütun sıra sayılarını belirler IColumnsInfo veya sıra sayılarını tarafından döndürülen sütun meta veri satır kümesi IColumnsRowset.
IColumnsInfo ve IColumnsRowset arabirimleri, satır kümesi sütunları hakkında bilgi ayıklamak için kullanılır. IColumnsInfo arabirimi döndürür bilgi, sınırlı sayıda ise IColumnsRowset tüm meta verileri sağlar.
[!NOT]
İçinde SQL Serveristeğe bağlı meta veri sütunu dbcolumn_computemode döndürülen sürüm 7.0 ve daha önceki IColumnsInfo::GetColumnsInfo (DBSTATUS_S_ISNULL açıklayan sütunu hesaplanan değerleri yerine) döndürür çünkü temel sütunu hesaplanan belirlenemiyor.
Sıra sayılarını bir sütunu bağlama belirtmek için kullanılır. Bağlama tüketici yapısı öğesi sütun ile ilişkilendiren bir yapıdır. Bağlama veri değeri, uzunluğu ve durumu değeri sütunun bağlayabilirsiniz.
Bağlantılar bir dizi, bir erişimci birlikte toplanır. Bu kullanılarak oluşturulan IAccessor::CreateAccessor yöntemi. Alınan veya tek bir görüşme ayarlamak için birden çok sütun veri erişenine çoklu bağlantıları içerebilir. Tüketici uygulamanın farklı yerlerinde farklı kullanım desenlerini maç için birkaç erişimcileri oluşturabilirsiniz. O oluşturabilir ve erişimcileri bıraktığınızda satır kümesi varlığı kalır.
Satırlar veritabanından getirmeye yönelik tüketici bir yöntem gibi aramalar IRowset::GetNextRows veya IRowsetLocate::GetRowsAt. Bu işlemler satır verileri sunucudan sağlayıcı satır belleğe yerleştirmek getir. Tüketiciye doğrudan erişim sağlayıcı satır arabellek yok. Tüketici kullanımları IRowset::GetData veri sağlayıcısının arabellek tüketici arabelleğine kopyalamak için ve IRowsetChange::setData veri değişiklikleri tüketici arabellek sağlayıcı arabelleğine kopyalamak için.
Tüketici çağrılarını GetData yöntemi ve ele geçen bir erişimci tanıtıcı ve tüketici tarafından ayrılmış arabellek bir işaretçi bir satır. GetData veri dönüştürür ve bağlamaları erişeni oluşturmak için kullanılan belirtilen sütunlar döndürür. Tüketici-ebilmek seslenmek GetData satırda birden çok kez farklı erişimcileri, tamponlar ve bu nedenle tüketici kullanarak aynı veriler için birden çok kopyasını edinebilirsiniz.
Değişken uzunlukta sütun verileri çeşitli yollarla tedavi edilebilir. Birincisi, böyle sütunlar tüketici yapısının sonlu bölüme bağlanabilir. Veri uzunluğu arabellek uzunluğu aşarsa bu kesilme neden olur. Tüketici, bu kesilme dbstatus_s_truncated durumunu kontrol ederek oluştu belirleyebilirsiniz. Böylece tüketici, ne kadar veri kesildi de belirleyebilirsiniz döndürülen her zaman gerçek uzunluğu bayt cinsinden uzunluğudur.
Tüketici alma veya satır güncelleştirme tamamlandığında, onlarla bültenleri ReleaseRows yöntemi. Bu satır satır kümesi kopyasından kaynakları serbest bırakır ve yeni satırlar için oda yapar. Tüketici, sonra kendi döngüsü alma veya satırları oluşturma ve bunları verilere erişme yineleyebilirsiniz.
Tüketici ile satır kümesi sona erdiğinde aramaları IAccessor::ReleaseAccessor yöntemi herhangi bir erişimci serbest bırakmak. Aramaları IUnknown::Release satır kümesi serbest bırakmak için satır kümesi tarafından maruz tüm arabirimlerdeki yöntemi. Satır kümesi serbest bırakıldığında, serbest kalan satırları veya erişimcileri tüketici tutabileceğini zorlar.