Exemple
GetRows
Acest exemplu demonstrează cum se utilizează metoda GetRows.
Obiectul Recordset
Obiectul ADO Recordset este utilizat pentru a păstra un set de înregistrări dintr-un tabel de baze de date. Un obiect Recordset constau din înregistrări și coloane (fields) .
În ADO, acest obiect este cel mai important și cel mai des folosite pentru a manipula datele dintr-o bază de date.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Când deschideți prima dată un Recordset, indicatorul de înregistrare curent va indica la prima înregistrare și BOF și proprietățile EOF sunt false. Dacă nu există înregistrări, BOF și proprietatea EOF sunt adevărate.
obiecte Recordset poate suporta două tipuri de actualizare:
- Immediate updating - toate modificările sunt scrise imediat la baza de date odată ce ați apela metoda de actualizare.
- Batch updating în Batch updating - furnizorul va cache mai multe modificări și apoi trimite - le la baza de date cu metoda UpdateBatch.
În ADO există 4 tipuri diferite de cursor definite:
- Dynamic cursor - Vă permite să vedeți adăugări, modificări și ștergeri de către alți utilizatori.
- Keyset cursor - Ca un cursor dinamic, cu excepția faptului că nu puteți vedea adăugiri de alți utilizatori, și împiedică accesul la înregistrările pe care alți utilizatori au șters. Modificări date de către alți utilizatori vor fi vizibile.
- Static cursor - Oferă o copie statică a unei înregistrări pentru a putea utiliza pentru a găsi date sau de a genera rapoarte. Adăugări, modificări sau eliminări de alți utilizatori nu vor fi vizibile. Acesta este singurul tip de cursor este permis atunci când deschideți un obiect Recordset client-side.
- Forward-only cursor - Vă permite să derulați numai înainte prin Recordset. Adăugări, modificări sau eliminări de alți utilizatori nu vor fi vizibile.
Tipul de cursor poate fi setat prin proprietatea CursorType sau de parametrul CursorType în Open metoda.
Note: Nu toți furnizorii acceptă toate metodele sau proprietăți ale obiectului Recordset.
Proprietăți
| Proprietate | Descriere |
|---|---|
| AbsolutePage | Setează sau returnează o valoare care specifică numărul paginii în obiectul Recordset |
| AbsolutePosition | Setează sau returnează o valoare care specifică poziția ordinal a înregistrării curente în obiectul Recordset |
| ActiveCommand | Returnează obiectul de comandă asociat cu Recordset |
| ActiveConnection | Setează sau returnează o definiție pentru o conexiune în cazul în care conexiunea este închisă, sau obiectul Connection curent în cazul în care conexiunea este deschisă |
| BOF | Returnează true dacă poziția curentă de înregistrare este înainte de prima înregistrare, în caz contrar fals |
| Bookmark | Setează sau returnează un marcaj. Marcajul salvează poziția înregistrării curente |
| CacheSize | Setează sau returnează numărul de înregistrări care pot fi memorate în cache |
| CursorLocation | Setează sau returnează locația serviciului cursorului |
| CursorType | Setează sau returnează tipul cursorului unui obiect Recordset |
| DataMember | Setează sau returnează numele membrului de date care vor fi preluate din obiectul de referință de DataSource |
| DataSource | Specifică un obiect care conține date care să fie reprezentat ca un obiect Recordset |
| EditMode | Returnează starea de editare a înregistrării curente |
| EOF | Returnează true dacă poziția curentă de înregistrare este după ultima înregistrare, în caz contrar fals |
| Filter | Setează sau returnează un filtru pentru datele într-un obiect Recordset |
| Index | Setează sau returnează numele indexului curent pentru un obiect Recordset |
| LockType | Setează sau returnează o valoare care specifică tipul de blocare la editarea unei înregistrări într-un Recordset |
| MarshalOptions | Setează sau returnează o valoare care specifică înregistrările trebuie să fie returnate la server |
| MaxRecords | Setează sau returnează numărul maxim de înregistrări pentru a reveni la un obiect Recordset dintr-o interogare |
| PageCount | Returnează numărul de pagini cu date într-un obiect Recordset |
| PageSize | Setează sau returnează numărul maxim de înregistrări permise pe o singură pagină a unui obiect Recordset |
| RecordCount | Returnează numărul de înregistrări într-un obiect Recordset |
| Sort | Setează sau returnează numele câmpurilor din Recordset pentru a sorta |
| Source | Setează o valoare șir de caractere sau o referință obiect de comandă, sau returnează o valoare șir care indică sursa de date a obiectului Recordset |
| State | Returnează o valoare care descrie dacă obiectul Recordset este deschis, închis, conectarea, executarea sau recuperarea datelor |
| Status | Returnează starea înregistrării curente cu privire la actualizări lot sau alte operațiuni în vrac |
| StayInSync | Setează sau se întoarce dacă trimiterea la înregistrările copilului se va schimba atunci când înregistrarea părinte schimbările de poziție |
metode
| Metodă | Descriere |
|---|---|
| AddNew | Creează un nou record |
| Cancel | Revocă o execuție |
| CancelBatch | Revocă o actualizare lot |
| CancelUpdate | Revocă modificările aduse o înregistrare a unui obiect Recordset |
| Clone | Creează un duplicat al unui Recordset existent |
| Close | Închide un Recordset |
| CompareBookmarks | Compară două marcaje |
| Delete | Șterge o înregistrare sau un grup de înregistrări |
| Find | Căutările pentru o înregistrare într-un Recordset care îndeplinește o criterii specificate |
| GetRows | Copii mai multe înregistrări dintr-un obiect Recordset într-o matrice bidimensională |
| GetString | Returnează un Recordset ca un șir de caractere |
| Move | Deplasează indicatorul de înregistrare într-un obiect Recordset |
| MoveFirst | Mută indicatorul de înregistrare la prima înregistrare |
| MoveLast | Mută indicatorul de înregistrare la ultima înregistrare |
| MoveNext | Mută indicatorul de înregistrare la următoarea înregistrare |
| MovePrevious | Mută indicatorul de înregistrare la înregistrarea anterioară |
| NextRecordset | Golește obiectul Recordset curent și returnează următorul obiect Recordset de looping printr-o serie de comenzi |
| Open | Deschide un element de bază de date care oferă acces la înregistrări într-un tabel, rezultatele unei interogări, sau la un Recordset salvat |
| Requery | Actualizează datele într-un Recordset prin re-executarea interogării care a făcut Recordset originală |
| Resync | Reîmprospătează datele din curent Recordset din baza de date originală |
| Save | Salvează un obiect Recordset într-un fișier sau un obiect Stream |
| Seek | Căutări indicele unui Recordset pentru a găsi o înregistrare care se potrivește cu valorile specificate |
| Supports | Returnează o valoare boolean care definește dacă este sau nu un obiect Recordset suportă un anumit tip de funcționalitate |
| Update | Salvează toate modificările efectuate într-o singură înregistrare într-un obiect Recordset |
| UpdateBatch | Salvează toate modificările într-un Recordset la baza de date. Utilizat atunci când se lucrează în modul de actualizare lot |
Evenimente
Note: Nu puteți manipula evenimente folosind VBScript sau JScript (numai Visual Basic, Visual C ++ și Visual J ++ limbi pot ocupa de evenimente).
| Eveniment | Descriere |
|---|---|
| EndOfRecordset | Declanșate atunci când încercați să mutați la un nivel record după ultima înregistrare |
| FetchComplete | Declanșate după toate înregistrările într-o operațiune asincron au fost preluate |
| FetchProgress | Declanșat periodic, într-o operațiune asincron, să precizeze cât de mult mai multe înregistrări care au fost preluate |
| FieldChangeComplete | Declanșate după valoarea unei modificări obiect de câmp |
| MoveComplete | Declanșate după poziția curentă în Recordset sa schimbat |
| RecordChangeComplete | Declanșat după o înregistrare sa schimbat |
| RecordsetChangeComplete | Declanșate după ce Recordset sa schimbat |
| WillChangeField | Declanșat înainte de valoarea unui obiect schimbare câmp |
| WillChangeRecord | Declanșat înainte de o schimbare de înregistrare |
| WillChangeRecordset | Declanșat înainte de o schimbare Recordset |
| WillMove | Declanșat înainte de poziția curentă în modificările Recordset |
Colecții
| Colectie | Descriere |
|---|---|
| Fields | Indică numărul de obiecte de câmp în obiectul Recordset |
| Properties | Conține toate obiectele de proprietate în obiectul Recordset |
Proprietăți din Colecția Fields lui
| Proprietate | Descriere |
|---|---|
| Count | Returnează numărul de elemente din colecție domenii. Pornește de la zero. Exemplu: countfields = rs.Fields.Count |
| Item(named_item/number) | Returnează un element specificat în colecția câmpuri. Exemplu: itemfields = rs.Fields. Item(1) |
Proprietăți Proprietăți colecției
| Proprietate | Descriere |
|---|---|
| Count | Returnează numărul de elemente din colecție de proprietăți. Pornește de la zero. Exemplu: countprop = rs.Properties.Count |
| Item(named_item/number) | Returnează un element specificat în colecția de proprietăți. Exemplu: itemprop = rs.Properties. Item(1) |