Przykłady
GetRows
Ten przykład pokazuje, jak użyć metody GetRows.
rekordów obiektu
Obiekt ADO rekordów służy do przechowywania zestawu rekordów z tabeli bazy danych. Obiekt składa się z rekordów rekordów i kolumn (fields) .
W ADO Ten przedmiot jest najważniejszy i jeden używany najczęściej do manipulowania danymi z bazy danych.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Kiedy po raz pierwszy otworzyć Recordset, bieżący wskaźnik rekordu będzie wskazywać na pierwszej płycie i BOF i właściwości EOF są fałszywe. Jeśli nie ma żadnych rekordów, BOF i właściwość EOF są prawdziwe.
Zestawu rekordów obiekty mogą obsługiwać dwa rodzaje aktualizacji:
- Immediate updating - wszystkie zmiany są zapisywane bezpośrednio do bazy danych po wywołaniu metody Update.
- Batch updating - dostawca będzie buforować wiele zmian, a następnie przesłać je do bazy danych z metodą UpdateBatch.
ADO istnieją 4 różne rodzaje kursora określoną:
- Dynamic cursor - Pozwala zobaczyć uzupełnień, zmian i skreśleń przez innych użytkowników.
- Keyset cursor - Jak dynamicznego kursora, poza tym, że nie można zobaczyć dodane przez innych użytkowników, a to uniemożliwia dostęp do dokumentacji, że inni użytkownicy nie usuniętych. zmiany danych przez innych użytkowników będą nadal widoczne.
- Static cursor - zapewnia statyczną kopię rekordów do użycia znaleźć dane lub generowania raportów. Uzupełnienia, zmiany lub usunięcia przez innych użytkowników nie będą widoczne. Jest to jedyny rodzaj kursora wolno podczas otwierania obiektu Recordset po stronie klienta.
- Forward-only cursor - Pozwala tylko przewijać przez rekordów. Uzupełnienia, zmiany lub usunięcia przez innych użytkowników nie będą widoczne.
Typ kursora może być ustawiona przez obiekt CursorType lub przez parametr CursorType w otwartej metodzie.
Note: Nie wszyscy operatorzy obsługują wszystkie metody lub właściwości obiektu rekordów.
Nieruchomości
| Nieruchomość | Opis |
|---|---|
| AbsolutePage | Ustawia lub zwraca wartość, która określa liczbę stron w obiekcie Recordset |
| AbsolutePosition | Ustawia lub zwraca wartość określającą porządkowej pozycji bieżącego rekordu w obiekcie Recordset |
| ActiveCommand | Zwraca obiekt polecenia związanego z Recordset |
| ActiveConnection | Ustawia lub zwraca definicję połączenia, jeśli połączenie jest zamknięta, czy obecny obiekt Connection, czy połączenie jest otwarte |
| BOF | Zwraca true, jeśli aktualna pozycja płyta jest przed pierwszym rekordzie, w przeciwnym przypadku false |
| Bookmark | Ustawia lub zwraca zakładkę. Zakładka zapisuje pozycję bieżącego rekordu |
| CacheSize | Ustawia lub zwraca liczbę rekordów, które mogą być buforowane |
| CursorLocation | Ustawia lub zwraca lokalizację usługi kursora |
| CursorType | Zestawy lub zwraca typu kursora obiektu Zestaw rekordów |
| DataMember | Ustawia lub zwraca nazwę elementu danych, które będą pobierane z obiektu wskazywanego przez właściwość DataSource |
| DataSource | Określa się przedmiot zawierający dane być przedstawiony jako Recordset |
| EditMode | Zwraca status edycji bieżącego rekordu |
| EOF | Zwraca true, jeśli aktualna pozycja płyta jest po ostatnim rekordzie, w przeciwnym przypadku false |
| Filter | Ustawia lub zwraca filtr dla danych w obiekcie Recordset |
| Index | Ustawia lub zwraca nazwę bieżącego indeksu dla obiektu Recordset |
| LockType | Ustawia lub zwraca wartość, która określa rodzaj ryglowania podczas edycji rekordu w zestawie rekordów |
| MarshalOptions | Ustawia lub zwraca wartość, która określa, które rekordy mają być zwrócone do serwera |
| MaxRecords | Ustawia lub zwraca maksymalną liczbę rekordów, aby powrócić do obiektu Zestaw rekordów z kwerendy |
| PageCount | Zwraca liczbę stron z danymi w obiekcie Recordset |
| PageSize | Ustawia lub zwraca maksymalną liczbę rejestrów dopuszczonych na jednej stronie obiektu Recordset |
| RecordCount | Zwraca liczbę rekordów w obiekcie Recordset |
| Sort | Ustawia lub zwraca nazwy pól w zestawie rekordów, aby posortować |
| Source | Ustawia wartość łańcuchową lub odniesienie do obiektu polecenia, lub zwraca wartość String wskazującą źródło danych obiektu Recordset |
| State | Zwraca wartość, która określa, czy obiekt rekordów jest otwarte, zamknięte, podłączenia, wykonywania lub pobierania danych |
| Status | Zwraca status bieżącego rekordu w odniesieniu do aktualizacji wsadowych lub innych operacji masowych |
| StayInSync | Ustawia lub zwraca, czy odniesienie do zapisów dzieci ulegnie zmianie po zmianie pozycji rekordowe rodzic |
metody
| metoda | Opis |
|---|---|
| AddNew | Tworzy nowy rekord |
| Cancel | Anuluje wykonanie |
| CancelBatch | Anuluje aktualizację wsadowego |
| CancelUpdate | Anuluje zmiany wprowadzone do rekordu obiektu Recordset |
| Clone | Tworzy duplikat istniejącej Recordset |
| Close | Zamyka Recordset |
| CompareBookmarks | Porównuje dwie zakładki |
| Delete | Usuwa rekordu lub grupy rekordów |
| Find | Wyszukiwania dla rekordu w zestawie rekordów, który spełnia kryteria określony |
| GetRows | Kopie wielokrotne rekordy od obiektu Zestaw rekordów do tablicy dwuwymiarowej |
| GetString | Zwraca Recordset jako ciąg |
| Move | Przesuwa wskaźnik rekordu w obiekcie Recordset |
| MoveFirst | Przesuwa wskaźnik rekordu do pierwszego rekordu |
| MoveLast | Przesuwa wskaźnik rekordu do ostatniego rekordu |
| MoveNext | Przesuwa wskaźnik rekordu do następnego rekordu |
| MovePrevious | Przesuwa wskaźnik rekordu do poprzedniego rekordu |
| NextRecordset | Usuwa bieżący obiekt Recordset i zwraca następny obiekt Recordset poprzez zapętlenie poprzez serię poleceń |
| Open | Otwiera element bazy danych, która umożliwia dostęp do zapisów w tabeli wyników kwerendy lub zapisanego Recordset |
| Requery | Aktualizuje dane w zestawie rekordów poprzez ponowne wykonującego kwerendy, który wydał pierwotną Recordset |
| Resync | Odświeża dane w bieżącym zestawie rekordów z oryginalnej bazy danych |
| Save | Zapisuje obiekt rekordów do pliku lub obiektu Stream |
| Seek | Przeszukuje indeks Recordset znaleźć zapis, który odpowiada wartości podanych |
| Supports | Zwraca wartość logiczną, która określa, czy dany przedmiot rekordów obsługuje określony typ funkcjonalności |
| Update | Zapisuje wszystkie zmiany wprowadzone do jednego rekordu w zestawie rekordów obiektu |
| UpdateBatch | Zapisuje wszystkie zmiany w rekordów do bazy danych. Wykorzystywane podczas pracy w trybie wsadowym aktualizacji |
Wydarzenia
Note: Nie można obsługiwać zdarzenia za pomocą VBScript lub JScript (tylko w języku Visual Basic, Visual C ++ i J ++ języki wizualne może obsługiwać zdarzenia).
| Zdarzenie | Opis |
|---|---|
| EndOfRecordset | Wyzwalane podczas próby przenieść się do rekordu po ostatnim rekordzie |
| FetchComplete | Wyzwalane po wszystkie rekordy w asynchronicznej operacji były naciągane |
| FetchProgress | okresowo wyzwalane w asynchronicznej operacji, aby stwierdzić, jak wiele innych zapisów, które zostały pobrane |
| FieldChangeComplete | Wyzwalane po wartości zmiany obiektu Pole |
| MoveComplete | Wyzwalane po aktualna pozycja w zestawie rekordów zmieniła |
| RecordChangeComplete | Wyzwalane po rekord został zmieniony |
| RecordsetChangeComplete | Wyzwalane po rekordów zmieniła |
| WillChangeField | Wyzwalane przed wartością zmiany obiektu Pole |
| WillChangeRecord | Wywołany przed zmianą rekordu |
| WillChangeRecordset | Wywołany przed zmianą Zestaw rekordów |
| Przesuną się | Wyzwalane przed aktualnej pozycji w zmianach Recordset |
Kolekcje
| Kolekcja | Opis |
|---|---|
| Fields | Wskazuje liczbę obiektów terenowych w obiekcie Recordset |
| Properties | Zawiera wszystkie obiekty mienia w obiekcie Recordset |
Właściwości pól Collection
| Nieruchomość | Opis |
|---|---|
| Count | Zwraca liczbę elementów w kolekcji pól. Zaczyna się od zera. Przykład: countfields = rs.Fields.Count |
| Item(named_item/number) | Zwraca określoną pozycję w kolekcji pól. Przykład: itemfields = rs.Fields. Item(1) |
Właściwości Właściwości Collection
| Nieruchomość | Opis |
|---|---|
| Count | Zwraca liczbę elementów w kolekcji właściwości. Zaczyna się od zera. Przykład: countprop = rs.Properties.Count |
| Item(named_item/number) | Zwraca określoną pozycję w kolekcji właściwości. Przykład: itemprop = rs.Properties. Item(1) |