Örnekler
GetRows
Bu örnek GetRows yöntemini nasıl kullanılacağını göstermektedir.
Kayıt Kümesi Nesne
ADO Kayıt nesne veri tabanı tablosundaki kayıtları bir dizi tutmak için kullanılır. Bir Recordset nesnesi kayıtları ve sütunlardan (fields) .
Ado, bu amaç, en önemli ve bir veritabanından verileri işlemek için en sık kullanılan bir başlangıç.
Progıd'ın
set objRecordset=Server.CreateObject("ADODB.recordset")
İlk kez bir Recordset açtığınızda, geçerli kayıt işaretçisi ilk kayıt ve BOF işaret eder ve EOF özellikleri False. Hiçbir kayıt varsa, BOF ve EOF özelliği true bulunmaktadır.
Recordset nesneleri güncellenmesi iki tür destekler:
- Immediate updating - Update yöntemini çağırmak kez tüm değişiklikleri veritabanına hemen yazılır.
- Batch updating - sağlayıcı birden fazla değişiklik önbelleğe ve sonra UpdateBatch yöntemi ile veritabanına bunları gönderir.
ADO tanımlanan 4 farklı imleç türü vardır:
- Dynamic cursor - diğer kullanıcılar tarafından eklenen, değişiklikleri ve silme görmesine izin verir.
- Keyset cursor - Eğer diğer kullanıcılar tarafından eklenen göremiyorum, ve başka kullanıcıların sildiniz kayıtlara erişimi engelleyen dışında dinamik bir imleç gibi. Diğer kullanıcılar tarafından Veri değişiklikleri hala görünür olacaktır.
- Static cursor - Raporları verileri bulmak veya üretmek için kullanmak için bir kayıt statik bir kopyasını verir. diğer kullanıcılar tarafından İlaveler, değişiklikler veya silme görünmeyecektir. Bu, bir istemci tarafı Recordset nesnesi açtığınızda izin imlecin tek türüdür.
- Forward-only cursor - Eğer sadece Recordset ileri kaydırma verir. diğer kullanıcılar tarafından İlaveler, değişiklikler veya silme görünmeyecektir.
İmleç türü CursorType özelliğiyle veya Açık yöntemde CursorType parametresi ile ayarlanabilir.
Note: Tüm sağlayıcılar Recordset nesnesinin tüm yöntemleri ve özellikleri destekler.
Özellikleri
| özellik | Açıklama |
|---|---|
| AbsolutePage | Setler veya Recordset nesnesinde sayfa numarasını belirten bir değer döndürür |
| AbsolutePosition | Setler veya Recordset nesnesinde geçerli kaydın sıralı konumunu belirten bir değer döndürür |
| ActiveCommand | Recordset ile ilişkili komut nesnesi döndürür |
| ActiveConnection | Bağlantı açıksa ayarlar veya bağlantı kapalıysa bir bağlantı için bir tanım verir, veya geçerli bağlantı nesnesi |
| BOF | Şu anki rekor pozisyon ilk kayıt önce ise aksi false, true döndürür |
| Bookmark | Ayarlar veya bir favori döndürür. Yer işareti, mevcut kaydın konumunu kaydeder |
| CacheSize | Ayarlar veya önbelleğe alınmış olabilir kayıtların sayısını döndürür |
| CursorLocation | Ayarlar veya imleç servis konumunu döndürür |
| CursorType | Ayarlar veya bir Recordset nesnesinin imleç türünü döndürür |
| DataMember | Ayarlar veya DataSource özelliği tarafından başvurulan nesneden alınır veri üyesi adını döndürür |
| DataSource | verileri içeren bir amacı, bir Recordset nesne olarak temsil edilebilir belirtir |
| EditMode | Geçerli kaydın düzenleme durumunu döndürür |
| EOF | Şu anki rekor pozisyon son kaydın sonra ise aksi false, true döndürür |
| Filter | Ayarlar veya Recordset nesnesindeki verileri için bir filtre döndürür |
| Index | Ayarlar veya bir Recordset nesnesi için geçerli endeksinin adını döndürür |
| LockType | Ayarlar veya Recordset'te bir kayıt düzenlerken kilitleme türünü belirten bir değer verir |
| MarshalOptions | Ayarlar veya kayıt sunucusuna iade edilecek olan belirten bir değer döndürür |
| MaxRecords | Ayarlar veya en fazla kayıt sayısını döndüren bir sorgudan bir Recordset nesnesine geri dönmek için |
| PageCount | Bir Recordset nesnesi verilerle sayfa sayısını döndürür |
| PageSize | Ayarlar veya bir Recordset nesnesinin tek bir sayfada izin kayıtların sayısını döndürür |
| RecordCount | Bir Recordset nesnesi kayıtların sayısını döndürür |
| Sort | Recordset'te ayarlar veya döndürür alan adlarını üzerinde sıralamak için |
| Source | bir dize değeri ya da bir komut nesne başvurusu ayarlar veya Recordset nesnesinin veri kaynağını belirtir geri döndürür |
| State | , Kayıt nesne açıksa tanımlayan bir değer verir yürütme veya veri alma, bağlantı, kapalı |
| Status | Toplu güncellemeler veya diğer toplu işlemleri ile ilgili olarak geçerli kaydın durumunu döndürür |
| StayInSync | Ayarlar veya döner çocuk kayıtlarına referans zaman üst kayıt pozisyon değişiklikleri değişecek olup olmadığı |
Yöntemler
| Yöntem | Açıklama |
|---|---|
| AddNew | Yeni bir kayıt oluşturur |
| Cancel | Bir yürütme iptal |
| CancelBatch | Bir toplu güncelleştirme iptal |
| CancelUpdate | Bir Recordset nesnesinin bir rekor yapılan değişiklikleri iptal eder |
| Clone | Varolan Recordset'in bir kopyasını oluşturur |
| Close | Recordset kapatır |
| CompareBookmarks | İki imlerini karşılaştırır |
| Delete | bir kayıt veya kayıt grubunu siler |
| Find | Belirtilen kriterleri karşılayan bir Recordset'te rekor arar |
| GetRows | iki boyutlu bir diziye kopyalar Recordset nesnesinden birden fazla kayıt |
| GetString | bir dize olarak bir Recordset döndürür |
| Move | Bir Recordset nesnesinde kayıt işaretçisini hareket ettirir |
| MoveFirst | ilk kayda kayıt işaretçisini taşır |
| MoveLast | Geçen kayda kayıt işaretçisini hareket ettirir |
| MoveNext | Bir sonraki kayda kayıt işaretçisini hareket ettirir |
| MovePrevious | Bir önceki kayda kayıt işaretçisini hareket ettirir |
| NextRecordset | mevcut kayıt nesnesini siler ve komutları bir dizi döngü tarafından sonraki kayıt nesnesi döndürür |
| Open | Eğer, bir tablodaki kayıtların bir sorgunun sonuçlarını erişim sağlayan bir veritabanı öğesi açar veya kaydedilmiş bir Recordset'e |
| Requery | Orijinal Recordset yapılan yeniden çalıştırarak sorgu tarafından bir Recordset'te verileri günceller |
| Resync | Orijinal veritabanından geçerli Recordset'te verileri yeniler |
| Save | Bir dosya veya bir Akış nesnesi bir Recordset nesnesi kaydeder |
| Seek | Belirtilen değerlere uyan bir kayıt bulmak için bir Recordset'in endeksi Aramalar |
| Supports | Bir Recordset nesnesi işlevselliği belirli bir tip destekler olup olmadığını tanımlayan bir Boole değeri döndürür |
| Update | Bir Recordset nesnesinde tek bir kayıt yapılan tüm değişiklikleri kaydeder |
| UpdateBatch | Veritabanına bir Recordset'te tüm değişiklikleri kaydeder. Toplu güncelleme modunda çalışırken kullanılır |
Olaylar
Note: Sen (olayları işleyebilir sadece Visual Basic, Visual C ++ ve Visual J ++ dilleri) VBScript veya JScript kullanarak olayları işleyemez.
| Olay | Açıklama |
|---|---|
| EndOfRecordset | son kayda sonra kayda gitmek çalıştığınızda Tetiklendi |
| FetchComplete | Zaman uyumsuz operasyonda tüm kayıtlar alınamadı olmuştur sonra Tetiklendi |
| FetchProgress | Zaman uyumsuz operasyonda periyodik Tetiklendi, getirilen olduklarını daha kaç kayıt devlet |
| FieldChangeComplete | Bir alan nesne değişim değerinden sonra Tetiklenmiş |
| MoveComplete | Recordset'te geçerli konum değişti sonra Tetiklendi |
| RecordChangeComplete | rekor değişti sonra Tetiklendi |
| RecordsetChangeComplete | Kayıt Kümesi değişti sonra Tetiklendi |
| WillChangeField | Bir alan nesne değişim değerinden önce Tetiklenmiş |
| WillChangeRecord | rekor değişikliğinden önce Tetiklendi |
| WillChangeRecordset | Bir Recordset değişikliğinden önce Tetiklendi |
| Hareket edecek | Recordset değişiklikler mevcut konumda önce tetiklediği |
Koleksiyonları
| Toplamak | Açıklama |
|---|---|
| Fields | Kayıt Kümesi nesnesindeki alan nesneleri sayısını gösterir |
| Properties | Recordset nesnesinde tüm Mülkiyet nesneleri içerir |
Alanlar Collection Özellikleri
| özellik | Açıklama |
|---|---|
| Count | alanları koleksiyonunda öğelerin sayısını döndürür. sıfırdan başlar. Örnek: countfields = rs.Fields.Count |
| Item(named_item/number) | alanları koleksiyonunda belirtilen bir öğeyi döndürür. Örnek: itemfields rs.Fields =. Item(1) |
Özellikler Collection Özellikleri
| özellik | Açıklama |
|---|---|
| Count | özellikleri koleksiyonunda öğelerin sayısını döndürür. sıfırdan başlar. Örnek: countprop = rs.Properties.Count |
| Item(named_item/number) | özellikleri koleksiyonunda belirtilen bir öğeyi döndürür. Örnek: itemprop rs.Properties =. Item(1) |