Konumlandırılmış Güncelleştirme ve Silme Deyimlerini Yürütme

Important

Bu özellik Windows'un gelecek bir sürümünde kaldırılacaktır. Bu özelliği yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bu özelliği kullanan uygulamaları değiştirmeyi planlayın. Microsoft, sürücünün imleç işlevinin kullanılmasını önerir.

Bir uygulama SQLFetchScroll ile bir veri bloğunu aldıktan sonra, bloktaki verileri güncelleyebilir veya silebilir. Konumlanmış bir güncelleme veya silme gerçekleştirmek için uygulama:

1. SQLSetPos'u çağırır, imleci güncellenecek veya silinecek satıra konumlandırır.

2. Aşağıdaki sözdizimi ile konumlanmış bir güncelleme veya silme ifadesi oluşturur:

   UPDATE Tablo adı

   SET Sütun tanımlayıcısı= {ifade | NULL}

   [,sütun tanımlayıcısı= {ifade | NULL}]

   GÜNCEL OLDUĞU YERimleç-adı

   DELETE FROMtablo adıWHERE CURRENT ofimlecer-name

   Konumlanmış güncelleme ifadesinde cümle SET oluşturmanın en kolay yolu, güncellenecek her sütun için parametre işaretçileri kullanmak ve bunları satırın güncelleneceği satırlar için satırlar tamponlarına bağlamak için SQLBindParameter kullanmaktır. Bu durumda, parametrenin C veri tipi, satır kümesi tamponunun C veri tipiyle aynı olacaktır.

3. Pozisyonlu bir güncelleme ifadesi çalıştıracaksa mevcut satır kümesi buffer'larını günceller. Konumlanmış güncelleme ifadesi başarıyla çalıştırıldıktan sonra, imleç kütüphanesi mevcut satırdaki her sütundan değerleri önbelleğe kopyalar.

   Caution

   Uygulama, konumlanmış güncelleme ifadesi çalıştırmadan önce satır kümesi tamponlarını doğru şekilde güncellemezse, bilemle çalıştırıldıktan sonra önbellekteki veri yanlış olur.

4. Konumlanmış update veya delete ifadesini, imleceğe bağlı ifadeden farklı bir ifade kullanarak çalıştırır.

   Caution

   Mevcut satırı tanımlamak için imleç kütüphanesi tarafından oluşturulan WHERE cümlesi herhangi bir satırı, farklı bir satırı tanımlayamayabilir veya birden fazla satırı tanımlayabilir. Daha fazla bilgi için bkz. Aranan Cümleler Oluşturma.

Tüm konumlanmış güncelleme ve silme ifadeleri bir imleç adı gerektirir. İmleç adını belirtmek için, bir uygulama imleç açılmadan önce SQLSetCursorName çağırır. Sürücü tarafından oluşturulan imleç adını kullanmak için, imleç açıldıktan sonra bir uygulama SQLGetCursorName çağırır.

İmleç kütüphanesi konumlanmış bir güncelleme veya silme ifadesi çalıştırdıktan sonra, imleç kütüphanesi tarafından tutulan durum dizisi, sıra kümesi tamponları ve önbellek aşağıdaki tabloda gösterilen değerleri içerir.

Kullanılan ifade	Değer sıralı durum dizisinde	Değerler Sıra kümesi tamponları	Değerler Önbellek tamponları
Konumlanmış güncelleme	SQL_SATIR_GUNCELLENDI	Yeni değerler[1]	Yeni değerler[1]
Konumlanmış silme	SQL_ROW_DELETED	Eski değerler	Eski değerler

[1] Uygulama, konumlanmış güncelleme ifadesini çalıştırmadan önce satır kümesi buffer'larındaki değerleri güncellemelidir; Konumlanmış güncelleme ifadesi çalıştırıldıktan sonra, imleç kütüphanesi sıralar kümesi buffer'larındaki değerleri önbelleğe kopyalar.