Aracılığıyla paylaş


Kayıt Kümesi: Kayıt Kümeleri Oluşturma ve Kapatma (ODBC)

Bu konu MFC ODBC sınıfları için geçerlidir.

Kayıt kümesi kullanmak için, kayıt kümesi nesnesi oluşturun ve kayıt kümesi sorgularını çalıştırmak ve kayıtları seçmek için Open üye işlevini çağırın.Kayıt kümesi ile işiniz bitirdiğinizde, nesneyi kapatın ve yok edin.

Bu konu şunları açıklar:

  • Kayıt kümesi nesnesini ne zaman ve nasıl kullanma.

  • Ne zaman ve nasıl kayıt kümesi davranışını parametrize ederek, filtreleyerek, sıralayarak veya kilitleyerek belirtebilme.

  • Kayıt kümesi nesnesini ne zaman ve nasıl kapatma.

Kayıt Kümelerini Çalışma Zamanında Oluşturma

Programınızda kayıt kümesi nesnelerini oluşturamadan önce, genelde uygulamaya özel kayıt kümesi sınıfları yazarsınız.Bu ön adım hakkında daha fazla bilgi için, bkz. MFC ODBC Tüketicisi Ekleme.

Veri kaynağından kayıt seçmeniz gerektiğinde, dynaset veya anlık görüntü nesnesi oluşturun.Oluşturulacak nesnenin türü, uygulamanızdaki veri ile ne yapmanız gerektiğine ve ODBC sürücünüzün neyi desteklediğine bağlıdır.Daha fazla bilgi için, bkz. Dynaset ve Anlık Görüntü.

Kayıt kümesi açmak için

  1. CRecordset türetilmiş sınıfınız için bir nesne oluşturun.

    Nesneyi yığında veya işlevin yığın çerçevesinde oluşturabilirsiniz.

  2. İsterseniz, varsayılan kayıt kümesi davranışını değiştirin.Kullanılabilen seçenekler için, bkz. Kayıt Kümesi Seçeneklerini Ayarlama.

  3. Nesnenin Open üye işlevini çağırın.

Yapıcıda, GetDefaultConnect üye işlevi tarafından döndürülen bağlantı dizesini temel alan frameworkün oluşturduğu ve açtığı geçici veritabanı nesnesini kullanmak için CDatabase nesnesine işaretçi veya NULL geçirin.CDatabase nesnesi zaten bir veri kaynağına bağlı olabilir.

Open çağrısı, veri kaynağından kayıtları seçmek için SQL kullanır.Seçilen ilk kayıt (eğer varsa) geçerli kayıttır.Bu kaydın alan değerleri kayıt kümesi nesnesinin alan veri üyelerinde saklanır.Eğer herhangi bir kayıt seçiliyse, IsBOF ve IsEOF üye işlevleri 0 döner.

Open çağrınızda, şunları yapabilirsiniz:

  • Kayıt kümesinin dynaset veya anlık görüntü olduğunu belirtin.Kayıt kümeleri varsayılan olarak anlık görüntü olarak açılır.Veya bir seferde bir kayıt olarak sadece ileri gitmeye izin veren salt ileri kayıt kümesi belirtebilirsiniz.

    Varsayılan olarak, kayıt kümesi CRecordset'in m_nDefaultType veri üyesinde saklanan varsayılan türü kullanır.Sihirbazlar, m_nDefaultType'ı sihirbazda seçtiğiniz kayıt kümesi türününe başlatmak için kod yazar.Bu varsayılanı kabul etmek yerine, diğer bir kayıt kümesi türü ile değiştirebilirsiniz.

  • Kayıt kümesinin oluşturduğu varsayılan SQL SELECT deyimini değiştirmek için dizgi belirtin.

  • Kayıt kümesinin salt okunur veya salt sonuna eklenir olduğunu belirtin.Kayıt kümeleri varsayılan olarak tam güncellemeye izin verir ancak, bunu sadece yeni kayıtları eklemeye kısıtlayabilir veya bütün güncellemeleri engelleyebilirsiniz.

Aşağıdaki örnek, salt okunur anlık görüntü nesnesinin CStudentSet sınıfını, uygulamaya özel sınıfı, nasıl açacağınızı gösterir:

// Construct the snapshot object
CStudentSet rsStudent( NULL );
// Set options if desired, then open the recordset
if(!rsStudent.Open(CRecordset::snapshot, NULL, CRecordset::readOnly))
    return FALSE;
// Use the snapshot to operate on its records...

Open'ı çağırdıktan sonra, kayıtlarla çalışmak için nesnenin üye işlevlerini ve veri üyelerini kullanın.Bazı durumlarda, veri kaynağında oluşan değişiklikleri dahil etmek için kayıt kümesini tekrar sorgulamak veya yenilemek isteyebilirsiniz.Daha fazla bilgi için bkz. Kayıt kümesi: Bir Kayıt Kümesinde Yeniden Sorgulama (ODBC).

İpucuİpucu

Geliştirme sürecinde kullandığınız bağlantı dizgisi, son kullanıcılarınızın ihtiyacı olan bağlantı dizgisiyle aynı olmayabilir.Bu bağlamda uygulamanızı genelleştirmeyle ilgili fikirler için bkz. Veri Kaynağı: Bağlantıları Yönetme (ODBC).

Kayıt Kümesi Seçeneklerini Ayarlama

Kayıt kümesi nesnenizi oluşturduktan sonra ama kayıtları seçmek için Open'ı çağırmadan önce, kayıt kümesinin davranışını denetlemek için bazı seçenekleri ayarlamak isteyebilirsiniz.Bütün kayıt kümeleri için, şunları yapabilirsiniz:

  • Kayıt seçimini kısıtlamak için filtre belirtin.

  • Kayıtlar için sıralama düzeni belirtin.

  • Çalışma zamanında hesaplanan veya alınan bilgileri kullanarak kayıtları seçebilmek için parametreler belirtin.

Eğer durumlar uygunsa, aşağıdaki seçeneği de ayarlayabilirsiniz:

  • Eğer kayıt kümesi güncellenebilirse ve kilitleme seçeneklerini destekliyorsa, güncellemeler için kullanılan kilitleme yöntemini belirtin.

[!NOT]

Kayıt seçimini etkilemek için, bu seçenekleri Open üye işlevini çağırmadan önce ayarlamalısınız.

Kayıt Kümesini Kapatma

Kayıt kümesi ile işiniz bittiğinde, kayıt kümesini bırakmalısınız ve belleğini kaldırmalısınız.

Kayıt kümesi kapatmak için

  1. Close üye işlevini çağırın.

  2. Kayıt kümesi nesnesini yok edin.

    Eğer işlevin yığın çerçevesinde bildirdiyseniz, nesne kapsam dışına çıktığında otomatik olarak yok edilir.Aksi takdirde, sil işlecini kullanın.

Close kayıt kümesinin HSTMT işleyicisini bırakır.C++ nesnesini yok etmez.

Ayrıca bkz.

Kavramlar

Kayıt Kümesi (ODBC)

Kayıt Kümesi: Kaydırma (ODBC)

Kayıt kümesi: Kayıtları Ekleme, Güncelleştirme ve Silme (ODBC)